THE APPLESOFT 
TUTORIAL 




popple computer inc. 

r 



cippkz computer inc. 

10260 Bandley Drive 
Cupertino, California 95014 






Apple Compute^ 
the product 
notice. 



NOTICE 

Inc. reserves the right to make improvements in 
described in this manual at any time and without 



DISCLAIMER OF ALL WARRANTIES AND LIABILITY 



ITS 



APPLE COMPUTE El 
IMPLIED, WITH 
SOFTWARE DESCRIBE 
MERCHANTABILITY 
COMPUTER INC. 
RISK AS TO 
SHOULD THE P 
THE BUYER 
RETAILER) ASS01ES 
REPAIR, OR 
DAMAGES . IN 
DIRECT, INDIRECT 
FROM ANY DEFECT 
BEEN ADVISED 
NOT ALLOW THE 
LIABILITY FOR 
LIMITATION OR 



This manual 1 
All rights 
part, be 
to any e 
consent , 



copied 
lectrjonic 
in 



INC. MAKES NO WARRANTIES, EITHER EXPRESS OR 
RESPECT TO THIS MANUAL OR WITH RESPECT TO THE 
IN THIS MANUAL, ITS QUALITY, PERFORMANCE, 
OR FITNESS FOR ANY PARTICULAR PURPOSE. APPLE 
SOFTWARE IS SOLD OR LICENSED "AS IS". THE ENTIRE 
QUALITY AND PERFORMANCE IS WITH THE BUYER. 

PROVE DEFECTIVE FOLLOWING THEIR PURCHASE, 
NOT APPLE COMPUTER INC., ITS DISTRIBUTOR, OR ITS 
THE ENTIRE COST OF ALL NECESSARY SERVICING, 
CORRECTION AND ANY INCIDENTAL OR CONSEQUENTIAL 
NO EVENT WILL APPLE COMPUTER INC. BE LIABLE FOR 

INCIDENTAL, OR CONSEQUENTIAL DAMAGES RESULTING 
IN THE SOFTWARE, EVEN IF APPLE COMPUTER INC. HAS 
OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO 
EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES OR 
INCIDENTAL OR CONSEQUENTIAL DAMAGES, SO THE ABOVE 
EXCLUSION MAY NOT APPLY TO YOU. 



• 
ft 






s copyrighted and contains proprietary information, 
reserved. This document may not, in whole or 
photocopied, reproduced, translated or reduced 
medium or machine readable form without prior 
Writing, from Apple Computer Inc. 



D1979 bj APPLE COMPUTER INC. 
10260 Eandley Drive 
Cupertino, California 95014 
(408) S96-1010 



All rights reserved 
Reorder APPLL 






Product 0A2L0018 

(030-0044- 



fc 

Si 



: 

n 

3' 



THE APPLESOF 



3 

3 



= 

: 

5 

: 

i 

i 
i 
i 

i 

i 




fe i 

! 



m 
m 



& 
t 



"J 



TABLE OF 



WELCOME 



CHAPTER i 
GETTING STARTED 



2 Introduction 

3 What you will neec 

4 Hooking up the TV 
4 Plugging in the g, 

4 The Disk II 

5 The cassette recoi 
5 The Apple keyboarc 
9 Keyboard notation 

10 Control, and other 

11 Setting the tape 
13 The usual procedu 
L4 Listening to a c 
15 Using a disk drive 
17 The Menu 

17 Stopping the compu|te 

18 Setting the TV co 

19 Playing Little Bri 



:oirp 



CONTENTS 



me controllers 



der 



: the RESET, SHIFT and ESC keys 

characters: the CTRL and REPT keys 
acorder 
5 for loading tapes 

uter tape: a helpful hint 



lor 



r 
k Out 



CHAPTER 2 



BEGINN 



22 
25 
26 
27 
29 
31 
32 
34 
35 
39 
41 



A first 
Applesoi 
More abc 
Easy edi 
Putting 
PLOT er 
Drawing 
The game 
Pigeon 
Preced 
How to 



NG APPLESOFT 



hoi 



look at the PRINT statement 

t's format for numbers 

ut RETURN 

ting features: the arrow keys 

colors on the screen: GR, TEXT, COLOR= and PLOT 

r messages 
lines 

controls: PDL 

es : an introduction to variables 

e among arithmetic operators, or who's on first? 

oid precedence 



CHAPTER 3 

ELEMENTARY PROGRAMMING 



44 
48 
50 
50 
52 
53 
54 
55 
59 
59 
60 
61 
62 
64 
67 
67 
68 
68 



Deferred execution: NEW, LIST, RUN and HOME 
Elementary editing: DEL 
Elementary aerobatics: GOTO loops 

e things that make life easier: more editing tips 
The moving cursor: editing with the ESC key 
A word about learning Applesoft BASIC 
An accident about to happen 

The truth: arithmetic and logical assertions 
precedence for operations 

tatement 

Saving programs on diskette: SAVE, CATALOG, RUN and LOAD 
Saving programs with a cassette recorder: SAVE 
More graphics programs: REM 
loops 

program 



Order or 
The IF s 



FOR /NEXT 
A wrong 



Getting 






A last example of nested loops 



flashy: INVERSE, FLASH and NORMAL 



PRINTs charming: comma, semi-colon, TAB, HTAB and VTAB 



fc 
fc 

fe 

m 
m 
& 

& 

m 
m 
m 
m 

m 

m 
fe 
m, 

m 
m 



I 



1 
1 
I 
a 

a 
a 
a 
a 
a 

3 



CHAPTER 4 

LOTS OF GRAPHICS 






rata on the RUM: INPUT and a bouncing ball 
program with lots of bounce 



74 Talking to a prog 

78 Off the walls: a 

79 Making sounds: PEjEK(-L6336) 
81 Noise for the bouncing ball 

81 For higher notes 

82 Random numbers: RND and INT 

84 Simulating a pair of dice 

85 Subroutines: drawing horses using GOSUB and RETURN 
87 Traces: TRACE, NO TRACE and END 

89 A better horse-drawing subroutine 

91 High-resolution graphics: HGR, HCOLOR= and HPLOT 



CHAPTER 5 
STRINGS AND ARRAYS 



10$ Stringing along: 

105 Concatenation go 

105 More string func 

108 Introducing arrals: DIM 

110 Array error messages 

111 Conclusion 



LEN, LEFT$, RIGHT $, MID$ and CLEAR 
: your tongue?: putting strings together 
;ions: VAL and STR$ 



VI 









fe 

fe ! 

Si 

:i 

fin ■ 

6 = 

fe = 

6e 
£i 
6i 
5 = 




CHAPTER 1 

GETTING STARTE 



2 Introduction 

3 What you will neec 

4 Hooking up the IV 
4 Plugging in the gape controllers 

4 The Disk II 

5 The cassette recorder 
5 The Apple keyboard 
9 Keyboard notation 

10 Control, and other 

11 Setting the tape 

13 The usual procedurle 

14 Listening to a 

15 Using a disk drive 
17 The Menu 

17 Stopping the computer 

18 Setting the TV color 

19 Playing Little Briik C 



; the RESET, SHIFT and ESC keys 

characters: the CTRL and REFT keys 
recorder 

for loading tapes 

t tape: a helpful hint 



INTRODUCTION 



This manual wlill 
will be a guid 
are an Old Ha ad 
and convenienc 
more fun. If 
find many fea 
programming a 
that 

doing . More 
remember — thi 



programming 



purchased 



If you 

dealer will b 
to make sure 
it as a gift 
up — it is as 
technical 



show you how to plug in your Apple (easy) and 
e as you learn to program it (also easy). If you 
at programming, you will find some new features 
es in Applesoft BASIC that make programming a lot 
you are a Newcomer to programming, you will also 
tures and conveniences in Applesoft BASIC that make 
lot of fun. But, if you are a Newcomer, be warned 
though not difficult, can only be learned by 
will be said on this topic later, but 
5 is a book to be used, not merely perused. 



your Apple from an authorized Apple dealer, the 
s willing to let you set your Apple up in the shop 
/ou know how to set it up at home. If you received 
jr through the mail, it is not difficult to hook 
>asy as setting up a stereo system, and no 
is needed at all. 



knowledge 

If you have n>t already done so, please take a few minutes to 
complete and nail your OWNER /WARRANTY REGISTRATION CARD. This 
Registration ^ard will register your Apple with the factory, 
give you membership in the Apple Software Bank, and include you 
in our list o:i Apple owners. If you don't send us this card you 
will not receive any newsletters, information about new 
accessories for your Apple, nor any of the other information 
that is frequently mailed to Apple owners. So please mail in 
the completed card. 



The Apple de 
computer 
board. If 
you have an 
you can find 
appendices in 
cassette or d 



languag 



□ 



ribed in this manual has the Applesoft BASIC 
e and the Autostart ROM installed on the main 
yoi)ir system differs from this one, for instance, if 

e II with Integer BASIC and the Old Monitor ROM, 
i:he information you need in one or more of the 
the back of this book. If you have Applesoft on 
skette watch for the 



symbol. This symbol indicates information that is of special 
interest to cassette and diskette Applesoft users. If these 
sections apply to you, be sure to read them carefully. If you 
don't, you map lose your program or part of the Applesoft 
program itself. 



Another symbo 
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L to watch for is the 
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The purpose of this 
Applesoft feature, 
lose your program. 



symbol Is to alert you to an unusual 
he situation described may cause you to 



WHAT YOU V/ILL NEED 



w 



the 



This manual was in 
contain 

1. The power cord (t\ 
wall) . 

2. A set of two game 
and knobs, connec 

3. A cable to connect 
has two plugs on 

4. Some cassette tape 
Apple. 



1. You will need 
have both, but 



accessory box. This box should also 
e cord that plugs into the outlet on the 



controllers (the black boxes with buttons 
t]ed with a cord) . 

the Apple to a tape recorder. This cable 
e|ach end. 

s. These tapes contain programs for the 



In addition to the Apple itself and the contents of the 
accessory box, you will need two more items chosen from the 
options below (none of these items are supplied) . 

one of the following items (it's useful to 
only one is necessary). 



OR 



a. A cassette recorder. 



b. The Apple Disk II disk drive with a controller card. 



2. You will also 
a. A color TV 



OR 



need one of the following items: 
nonitor and a cable that has a phono plug 
(also called a male RCA-type connector) at one end and 
something t3 match the monitor at the other end. The 
dealer that sells you the monitor can supply the 
cable. 

b. An ordinary home color TV and an M RF Modulator" with 
the connecting cables. The RF Modulator changes the 
signal put aut by the Apple so that it matches what 
your TV expects. A number of Modulators are 



There is one made especially for the Apple 
JUPERMOD II. Your computer dealer can 
11 you one, or, if not, it can be ordered 



available. 

called the 

probably se 

from 

M&R Enterprises 
P.O. Bo:c 61011 
SunnyvaLe, CA 94088 



The Modulator comes with instructions on how to hook it 

Your TV's ability to receive normal programs will not 
diminished (or enhanced) by having the Apple hooked up 



up 
be 
to it. 



A black 
not let 
color 



appear 
monitor 



pj c 



and white monitor or TV will work fine, but will 
you take advantage of Apple's ability to generate 

tures. Colors described in this manual will 
s different shades of grey on a black and white 
or TV. 



HOOKING UP THE TV 



If you have a color (or black and white) monitor, just connect 
the appropriate cable from the jack marked VIDEO OUT (on the 
rear of the Apple) to the input of the monitor. 



If you have an 
modulator. Open 
the back of the 
install the mqdul 
it. 



ordinary TV, you will have to install an RF 

the top of the Apple by pulling straight up on 
lid using both hands, one on each side. Then 
ator following the directions that come with 



PLUGGING IN THE GAME CONTROLLERS 

With the lid open, plug the controllers' rather delicate plug 
into the GAME I/O socket located in the right-rear corner (front 
view) of the Apple board. Be very careful and make sure that 
all the pins go into the socket. The plug's white dot should be 
toward the front (keyboard end) of the computer. 




THE DISK II 



thi 



If you have a 
preface and 
Operating Syst 
Disk II packag 
instructions o 



disk drive, unpack it carefully. Then read the 
first chapter (pages 2 through 8) of the Disk 

ira (usually called DOS) manual that came in the 
Those pages will give you complete 
how to set up your disk drive. 
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THE CASSETTE RECORDER 



(if you are not using 
if you are going to u 



a disk drive, or 

both recorder and disk) 



black plug to the MIC 
the other black plug 



(different brands use 
on the computer end oi 
"OUT" means "out of tr 



Use the supplied cabli (the one with two plugs on each end) to 
connect the Apple to your cassette tape recorder. Connect one 
or MICROPHONE jack on the recorder, and 
[on the opposite end of the cable) to the 
jack on the back of the computer marked CASSETTE OUT. Connect 
the grey plug on the recorder end of the cable to the recorder's 
EAR or EARPHONE or MOlf or MONITOR jack on the recorder 

different words). Connect the grey plug 

the cable to the jack marked CASSETTE IN. 
tie computer" and "IN" means "into the 
computer." All that remains is to plug the cassette recorder's 
power cord into a wall outlet, and it will be ready to use. 



computer's power cord 
next to the power swit 
grounded wall outlet, 
you have only to read 



Now close the top of the Apple. Plug the Apple end of the 



into the Apple (on the rear of the Apple, 
ch) , and the other end into a three-prong 
Now the Apple is completely set up , and 
on to begin exploring the fascinating 



world of personal computing. 



THE APPLE KEYBOARD 



The first thing to do, 
made, is to turn the 
computer next to where 
the upward position, 
at the bottom of the 
a key, and cannot be 
also appear at the top 
blinking square called 



now that all the connections have been 
AJpple on. The switch Is on the back of the 

the power cord plugs in. Push it into 
you will be rewarded by the "POWER" light 
keyboard coming on. The POWER light is not 
depressed. The title "APPLE II" should 

of the screen along with a ] and a 

the "cursor" to the far left. 








If your screen 
worry. If you 
into the Apple 
sure the switch 
Then turn your 
display still 
on a card, pr 
corner of the 
RESET key is 



display doesn't conform to the description, don't 
have the Applesoft II Firnware Card that plugs 
s main board (Apple Part Number A2B0009X), make 
on the back of the card is in the up position. 
Apple off and turn it on again. If your screen 
coesn't look right, or if you don't have Applesoft 

the key marked RESET in the upper right-hand 
keyboard. The Apple should go "beep" when the 
released. 




If your Apple 
instructions 
become familiar 
will usually 
the Apple off 
the trick. 



doesn 



(you 



renedy 
and 



results 



If you have a 
following 
followed by a 
USE" will come 
seems that it 
until you stop 
The title 
appear at the 



disk 



't seem to be responding correctly to your 
'11 find out what correct responses are as you 
with this manual) , a press of the £Hii key 
the problem* If that doesn't work, turning 
then turning it back on again will probably do 



drive, turning your Apple on will give the 

A few clacking noises will come from it, 
whirring sound, and a red light labelled "IN 

The disk drive will whir and whir until it 
never stop. As a mat ter of fact, it won't: 
it by pressing the EES key. Do that now. 
APPIE II" disappears, and the prompt and cursor 
bottom left of the screen. 



soft 

on. 

will 
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Study the keyboard. If 
typewriters, you will find 
keyboard and a typewrit 
case letters. You can 
This is all you need fo[r 



you are familiar with standard 

a few differences between the Apple 
er keyboard. First, there are no lower 
get only capital letters on the Apple, 
programming in Applesoft BASIC. 




Using the diagram, locate the two 
The reason the keyboard 



keys on the keyboard. 



has the E0j keys is to allow for 
nearly twice as many characters with the same number of keys, 
keyboard with a separate key for each character would be very 
large, making it hard to find any desired key. 



If you press a key which 
will appear on the scr 
holding down either of 
appear on the screen, 
the SHIFTed period are 
other symbols on the 
typewriter. Feel free 



Apjl 



If there is no upper 

£35i while the key i 
exceptions: the | and 






has two symbols on it, the lower symbol 
If you press the same key while 
ihe OS! keys, the upper symbol will 
bu will find that the SHIFTed comma and 
and > respectively. You will also find 
e keyboard that are not on a standard 
o try operating any of these keys. 



symbol on a key, then holding down the 

pressed has no effect. There are two 
the 1 . 




key gives a right hand square bracket (]). The 
Q key has t:he word "BELL" above the "G". But EH! Q does 
not put a beM on the screen, it just puts a "G" there. The 
meaning of the word "BELL" on the Q key will be explained 



The SHIFTed 
Q key has 



later. 

An important 
most typewrit : 
the number " 
Apple, but s 
for the lett 



When the Hin^u 

numeral zero 

a symbol tha 

looks just 1:. 

straight-thinking 

distinct. 

many other 

you can tell 

make the distinction 



The 



(T, 



difference between using the Apple keyboard and 
ers is that you cannot employ a lower case "L" for 
Of course, there is no lower case "L" on the 
typists will have to break the habit of reaching 
"L" when they mean the number "l". 



mathematicians invented the open circle for the 
they didn't use the Roman alphabet. So they chose 
, while not conflicting with their alphabet, 
ke our letter "0". The computer (and any 

individual) will want to keep zeros and oh's 
usual method for doing this, on the Apple and 
computers, is to put a slash through the zero. Now 
them apart. The keyboard and the TV display both 
clear. Try them. 



. f|| is mill If toi Him - ri 5§Ht= 

auMraan.vBSS 



^ 




After a bit sf typing, the screen tends to get full of stuff. 
To clear the screen, you need to use the key marked g-3 • ESC 
stands for the word "ESCape." The OS kev does not stlow U P on 
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the Apple's screen, 
by holding down either 
"P". Notice that the 
not need to be held 
operate three keys to 
release it. Then, 
gratification: the 



if 



tress (13 , and then type an "at" sign <@) 
EE3 key and pressi ng th e key marked 
ESC key, unlike the EEJ key, does 
ddwn while typing another key. You have to 
clear the screen. Fir st press S and 
rhjjle holding down OS1 , press P. Instant 
of the screen promptly disappear. 



contents 



^ 




^ 
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KEYBOARD NOTATION 



At this point we will 



introduce a simple notation. 



As you have seen, when 
for the letter "H" 
indicate pressing 
list the keys in the 



that 
several 



order 



exam pi 



On occasion, you will 
another key. F or 
hold down the BSB 
this dual action is 
keys, one above the o 



The upper key is to be 
Here's how to clear th » 



a key is to be pressed, such as the key 
key's symbol will be shown: H. To 
keys in succession, we will simply 
to be pressed: QQfBQO 



need to hold down one key while pressing 

e, to type a dollar-sign ($) you must 
icey while you press the 4 key. Whenever 
we will show the symbols for both 



required, 
tier. 



held down while the lower key is pressed, 
screen, using the new notation: 



Try it. 






CONTROL, 

AND OTHER UNSAVORY CHARACTERS 



When you press 



the 



key, the numeral 5 appears on the TV 



screen. You probably believe this is true, but try it anyway. 
If you hold the 355 key down while pressing the 8 key, a 
percent sign (%) should appear on the screen. Does it? The 

fri'si key permits some of the keys on the keyboard to have two 
different functions. Several of the keys also have a third 
third function is obtained by holding the 
other keys are pressed. "CTRL" stands for the 
Instead of putting new characters on the screen 
key, the computer responds by performing 
Control characters never appear on the screen. 



function. The 
key down while 
word "ConTRoL. 
when you use the 
certain actions 



Hold the 



It doesn't go 
computer wishes 
sound the beeji 
reasons: the 
Teletype. On 
bell. 




key down and press 



"ding", but it does go "beep." Whenever the 

to call your attention to something, it will 
er . is called "BELL" for historical 
present keyboard design is based on that of the 
that venerable machine, : . rings a real 



Another key that is not usually found on typewriters is the 

which stands for "REPeaT." Holding down the EUSi key 
while you press any other key just makes that key's character 
appear repeatedly on the sceen. You must first press and hold 
the key for the character you wish repeated and then hold down 
the E5a key. Experiment with it. 



There is also 
machines in 
the Apple, it 
screen's left 
computer 
press I 

10 



a key marked on the keyboard. On 
the past, this was the "carriage return" key. On 
causes the blinking cursor to "return" to the 
edge, but it is also a special message to the 
Moke about this message later. If you happen to 

you will sometimes get a "beep" and the message 



I 



m 

m 



m 



m 

\ 
\ 

a 



a 
a 
a 
a 



?3YiiT- .. ERROR 

will appear on the 
message. 



tr 



screen. For the time being, ignore this 



^ 




^ 



The only keys left unm 
move the cursor to the 
explained more fully 
you can find. There i 
keyboard that can caus 
type with a hammer 
fingers. 



J 



tioned are the \ and £3 keys. They 
left and the right. They will be 

Test out these keys and any others 
nothing you can do by typing at the 
any damage to the computer. Unless you 
feel free to experiment. With your 



later 



S( 




SETTING THE TAPE RECORDER 



(if you are not using a 
skip to the section cal 



casette recorder, 
Led "USING A DISK DRIVE".) 



that 



Now press the 

the blinking cursor 

know that you are "in ™ 

say). Now you are readp 

recorder. 



When you play a tape re 
making sounds that you 
some of the words or m 



key. The right hand square bracket ] and 
show on the screen's left edge let you 
Applesoft 11 or have Applesoft "up" (as they 
to set the volume control on the tape 



:order, it is usually with the intent of 
:an hear. If it is too soft, you miss 
ic. If it is too loud, it is annoying. 
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When you play 
intent of putting 
the volume 
information, 
If the volume 



the tape recorder into the Apple, it is with the 
the tape's information into the computer. If 
is too soft, the Apple will miss some of the 
it will complain by giving an error message, 
setting is too loud, the Apple will also complain. 



setting 
and 



To find the 
method . You 
and see if the 
will try the 
doesn't work, 
Eventually the 
will say so 



right 



t volume setting, you will use a trial-and-error 
play an Applesoft tape softly to the computer 
information got in OK. If it doesn't work, you 
again, a little louder this time. If that 
you will make it a little louder still, 
volume will be just right for the Apple, and it 
wijth a beep. 



will 



tape 



Place the tape 
each position 
following: 



To clear the screen for action type 



marked COLOR DEMOSOFT into your recorder. For 
of the volume control you are going to do the 



1. Rewind the tape to the beginning. 

2. Start the tape playing. 

3. Type: 

09 B B G9 

When you do thLs, the cursor will disappear. It may take up to 
15 seconds before something happens. There are these 
possibilities: 

a. The message 

b. Nothing at 



'SYNTAX LRRGR appears, 
all happens. 

: r or ERREHP appears (with or without a 



In case a, do 



1 where you rewind the tape 
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c. The message 
beep). 



d. The computer goes "beep" and nothing appears. 



not reset the volume control, but go back to step 



i 



6 i 

fi 




In cases b and c, make sure you waited for 15 seconds before 
giving up. If there is no prompt character or cursor, and the 
Apple does not respond to its keyboard, press (gjg| » set tne 
volume control a bit higher anil go back to step 1. Once in a 
great while the LOAD command may not work properly, and the 
cursor will appear on the screen immediately without waiting for 
the tape to be LOADed. If thU happens just turn your Apple off 
and then on again with the powfcr switch on the rear of the 
computer, and then try LOADing the tape again. 

In case d, you are on the right track. When you hear the beep, 
wait another fifteen seconds. Either you will get an error 
message (case c), or the prompt! character (]) and the blinking 
cursor will reappear. If they do reappear, stop and rewind the 
tape. Mark the position of the recorder's volume control, so 
that you can use this setting each time you LOAD a tape in the 
future. Then type 



The screen should look like this: 




THE USUAL PROCEDURE FOR LOADING TAPES 

(once the recorder's volume control has been set correctly) 

1. Rewind the tape. 

2. Start the tape playing. 

3. Type LOAD 

After you press ftT-Tfl the cursor will disappear. Nothing 
happens from 5 to 20 seconds:, and then the Apple beeps. 
This means that the tape's information has started to go 
into the computer. After some more time (depending on how 
much information was on the tape, but usually less than a 
few minutes) the Apple beeps again and the prompt character 
and the cursor reappear. 
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A. Stop the 
has been 
recorder 



Cape recorder and rewind the tape. The information 

ransferred, and you are finished with the tape 
for the time being. 



5. Type _■;■- ^nd press Egj , and your program will begin to 
execute. 

If your Appli is in the Applesoft BASIC computer language, the 
tape you are LOADing must be in Applesoft too. Trying to LOAD a 
tape in the vrong computer language gives results that are 
pretty much Unpredictable. Strange error messages and odd 
characters nuiy appear on your TV screen, you may loose keyboard 
control, or finy number of other odd things can happen. If this 
happens to ycu, turn your Apple off and then back on again to 
get everything back to normal. 



Computerniks use many different words to describe the process of 
taking information from a tape and putting the information into 
the computer J The computer is said to "read" (pronounced 
"reed") the tiape. The information on the tape is said to be 
"entered" or "read" (pronounced "red") into the computer. The 
act of reading a tape is also called "loading" a tape into the 
computer and the information on the tape is said to be "loaded 
into" the computer. All these expressions are ways of saying 
the same thir|g» 



A HELPFUL HINT 



What is it that the computer finds so interesting about these 
tapes? Listen to one of them. It's not music to your ears. 
Yet you can recognize some of the sounds the computer listens 
for. The information starts with a steady tone. Then there is 
a short "blip" followed by more of the steady tone. The tone is 
at 1000 cycles per second. This pitch is just below the C two 
octaves above middle C. After the tone cones a burst of sound 
rather reminiscent of a rainstorm. 

When you are used to the sound of a good tape, you can quickly 
check a tape by ear to see if it is a computer tape or not. If 
you can tell what the tape contains by listening to it, you are 
a mutant, anq will go far in the computer world. 
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USING A DISK DRIVE 

(Skip this section if you are not using a disk drive.) 

A disk drive is much quicker and easier to use than a cassette 
recorder, however, diskettes and disk drives are delicate 
creatures, and some cure must be taken to protect them. You 
will find information on their care and feeding on pages 5 
through 6 in your DOS manual in the section called CARE OF THE 
DISK II AND DISKETTES I Read that section carefully if you 
haven't already. 

The last section in the first chapter of the DOS manual is 
called INSERTING AND REMOVING DISKETTES. Get the System Master 
diskette from its package and insert it with the label facing up 
and the oval cutout toward the back of the disk drive, as 
described in the DOS ipanual. 

One of the features that make the Disk II so easy to use is its 
ability to store and retrieve several different groups of 
information. The groups of information are filed on the disk 
under names called file names. A program that keeps track of 
addresses, for instance, might be called ADDRESSES on the 
diskette. 



The programs that keei 
and do lots of other 
Disk Operating System 
capabilities to Apple; 
Apple) is called "boo 



track of files, save and retrieve them, 

housekeeping tasks are what make up the 

or DOS. The process of adding the DOS 

oft (or to any other language used by your 
ing DOS" or "booting the system". 



There are several ways' to boot DOS. One way is to simply turn 
your Apple off and turn it on again. The Disk drive's red "IN 
USE" light will come en again, and the Disk II will make the 
same whirring and clacking noises it made when the Apple was 
turned on for the first time. This time the disk drive will 
stop whirring on its cwn. When the whirring stops and the red 
light goes off, the title APPLE II will disappear and a message 
will come on the screen. 
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When you get tils message, you know that DOS is booted. The 
right-hand squire bracket and the blinking cursor that appear at 
the bottom lef : corner of the screen indicate that the Apple is 
in the Applesoft language (or has Applesoft "up", as they say) 
and is ready fpr instructions. 

Another way to boot DOS is to type 



■ 



on your Apple. If the controller card is not plugged into slot 
number six theiji type 



followed b y th^ number of whatever slot the card is plugged into 
and then G3EEJ . 

The System Mas :er is a very special diskette. It contains 
programs you'lL need in order to get the most out of this manual 
as well as many other useful programs. To see what programs are 
on the diskette, use the CATALOG command. Simply type 

CATALOG IthdW! 

and a list of filenames will appear on the screen. 



COPYRIGHT 1979 APPLE COMPUTER INC 



$€2 HELLO 

a S3 UPDATE 3 I 

[4 COPY 
u05 COLOR PEHOS0FT 
31 LITTLE BRICK OUT 

i 33 make [EXT 

i 83 RETflEuE TEXT 

If |Sec deho 

i 10 BUND0PI 
□3 APPLE PROMS 
35 REHfJHBER INSTRUCTIONS 
14 ftEHUHBttf 



The first program you need is called COLOR DEMOSOFT. Locate the 
name COLOR DEMOSOFT in the catalog. Now type 

RUN COLOR DEHOSOFT 

and then press flBB . The screen should look like the 
photograph on {he next page. 
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THE MENU 



Computerniks call this list of numbered descriptions a "menu." 
It works like a menu at a roadside cafe. If you want scrambled 
eggs with hash brown potatoes, toast, jelly and coffee you can 
just say, "I'll have a number 5." Try selecting one of the 
color demonstrations by typing its number (followed by a 

liiaiiHtl , of course). When you are viewing one of the demos, 
just press the bhil';^ to get back to the "menu." 



STOPPING THfi COMPUTER 



To stop the computer, U|Se 



cha :a 



This will cause the 
appear. The prompt 
with typing information 
called the prompt chara 



prompt character and blinking cursor to 

cter tells you that it is OK to proceed 
to the computer. That is why it is 
:ter: it "prompts" you to type something. 



Once the computer is stopped, it may be started again by typing 



RUN 



(and, of course, JiUfei , but you hardly need to be told that 
anymore. In fact, you ^on't be from now on.) 



Use 
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to stop the computer, and 

RUN 

to start it agaijti. Try this a few times. 

SETTING THE TV COLOR 

If the "menu" is! not on your screen, boot DOS and RUN the 
program called COLOR DEMOSOFT if you are using a disk drive. 
Or, if you are vising a cassette recorder, follow the Usual 
Procedure for ldading the tape marked "COLOR DEMOSOFT". One of 
the items on thJ menu is called STANDARD COLOR NAMES. We will 
use this DEMO to set the TV color. Type the number of the COLOR 
NAMES DEMO, 1, and press CUBED • A number of bars of light 
(perhaps in colox) will appear. Under each bar is a four letter 
abbreviation of b color name. The full names are: 



BLACK 

1 MAGENTA (a slightly bluish red) 

2 DARK BLUE 

3 PURPLE (a light purple, lavender) 

4 DARK GREEN 

5 GREY 

6 MEDIUM BLUE 

7 LIGHT BLUE 



8 BROWN 

9 ORANGE 

10 GREY 

11 PINK 

12 GREEN 

13 YELLOW 

14 AQUA 

15 WHITE 




If you have a blkck-and-white television or monitor, adjust the 
brightness and contrast until you are pleased. Of course, if 
the picture is f jipping over, stop it the way you would for any 
TV show. If you have a color set, a bit more work is necessary. 



3P 

These colors will be different in Europe and some other parts of 
the world. 



* ! 
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I* 
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I 
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Remember that this coldr business is quite subjective, and that 
you can do whatever you| want with the color. The following 
instructions will give the picture that we like, using the 
standard colors. But lit* a your eyes you must please. Besides, 
the optimum settings Willi vary with different amounts of room 
light. 

Turn off any Automatic Color switch. On some sets it is marked 
"AUTO COLOR" or simply f'AUTO". Turn the TV set volume control 
all the way down (but don't turn the set off). Four controls 
are now important: Picture, Brightness, Color and Hue. Some 
sets have a knob marked "Contrast" rather than "Picture," but it 
does the same thing. Turn the Picture control to its dimmest 
position, and then turn down the Brightness until the background 
just goes completely da;:k. Turn the Color control to the middle 
of its range. Now turn up the Picture control to make things 
brighter. Do not make :.t so bright that the colors "spill" off 
the edges of the bars too much. 



Now adjust the Color knob. At one extreme, all color is lost 
and the picture is black and white. This setting is handy when 
you are just showing text on the screen. Adjust the Color 
control until the colors are intense but not "blooming" or 
spilling into one another. Lastly, adjust the Hue knob until 
all the colors agree with their names. Purple, Pink and Yellow 
are especially sensitive indicators. Also, make sure that the 
three Blues are distinct. 

When the TV set's colors are OK, press the QHO key and the 
menu will reappear. Now try DEMO 2, which shows the color bars 
with their code numbers. Also try the other demonstrations. 
You'll never believe howl talented your TV is until you replace 
the local stations with your Apple. 

PLAYING LITTLE BRICK OUT 

RUN the program called LITTLE BRICK OUT from your diskette. Or, 
if you have a cassette recorder, put the tape labeled "LITTLE 
BRICK OUT" into your recorder, and use the Usual Procedure for 
getting the tape loaded. The screen will look like the photo on 
the left when you RUN th4 program. Then, when you press the 
space bar, a description of the game will appear on the screen. 
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mimmtttmmMmtmmmtmtt 

t BRICK OUT IS A DYNAMIC BQARO CAME t 

* IN UH1CH YOU ATTEMPT TO KNOCK DQUM I 
I A UAi,L OF BRICKS WITH A EALL t 

* STRUCK BY YOUR PADOLE 



! XH U xRS H I fi 9 L , T t! E PADDLE ON THE BOARD 

t BY TURNING THE APPLE PADQLE <.&> 

1 

t YOU HflY "PUT ENGLISH- OH THE BALL 

t (DEFLECT THE BALL >' BY HITTING [T 

* MlTH THE PAODLE HELD OFF-tEHTER 



?EFQRE HE BEGIN. PLEASE TYPE 
OUR HAHE AMD THEN PRESS 
hE key harked ■arrtJRM'l 



tmiiitimutttitti mitt tn ttttiftttt 



When asked, typi your name, and then press lawim 
type, for example, (as It appears on the screen): 



We will 



J. APPLESEED 

The Apple will 
paddle. The numbers 
number of points 
appropriate columns 
"wall", the mor^ 
If you type a 
program will 
comfortable with 



Respond by drawing the game board complete with 
just below the graphics display are the 
you can get for hitting bricks from the 

The farther you get through the brick 
points you get per brick. 
ie that is more than 12 characters long, the 

the name to a length it is more 
(12 characters). 



truncate 



Sometime you may accidentally press the ■:t»^a« key instead of 
the i5w'!:il'» key (it can happen); the screen will light up. 
Don't panic. Ji^st type 

RUN 

Don't forget that we are no longer mentioning BBffl every 
time it is necessary. 

Try deliberately making some errors, such as "accidentally" 
pressing the BBIl key* so that you can get some confidence in 
your ability to j recover from errors. 

Meanwhile, back at the LITTLE BRICK OUT program, the Apple 
instructs you t(|> 

Pu'SH F ADDLE flUTTON TO BEGIN GAME. 

so grab the gam<! control and begin the game. 



"Which control? 
will tell you i 
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you ask. Try them both and see. Your Apple 
you have chosen the wrong one. 
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BEGINNING APPLESOFT 

If you are in Applesoft, the square bracket prompt character 
(]), followed by the blinking cursor, will appear at the left 
edge of the screen each time you press 0E3 . Get into 
Applesoft and, jif you have a disk drive, boot DOS. 

A FIRST LOOK AT THE PRINT STATEMENT 

Now that you have the Applesoft prompt character (]) and the 



blinking cursor 
you have a disk 



on the screen, (and your diskette is booted if 
drive) you are ready to begin using the 



Applesoft language. Type 

PRINT "HELLO 1 

and the computet will print the word 



HELLO 

on the next lin 
"Did I forget t 
you will get th 



ip. If it didn't, ask yourself this question: 
le lilaiUjjJ ?" If you misspell the word "PRINT' 
Ls error message: 



■7SVMTAX CRROS 



3 

3 



If you forget e 
computer will 
slash): 



ither the first quote or both quotes, the 
int a zero (you can tell it's a zero by the 



PP 



If the final qubte is the last character before the E3EE3 , 
you don't have 'to type it: the word "HELLO" will be printed with 
or without it. It's a good idea to put the end quote in anyway, 
though. The habit of putting in the final quote will become 



important later 
quote. 

The statement 

PRINT "HELLO 11 



This manual will assume that you use the final 






is an instruction to the computer telling it to display on the 



screen all the 



characters between the quotes, in this case a 
g. You can use the PRINT statement to tell the 

However, if you type 



word of greetin; 

computer to display any message you wish 



I 
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much beyond 24(11 characters, the computer will start to beep, 
then give you a backwajrd slash and let you start over again. 



PRINT "HELLO" 
HELLO 

JPRINT "THE QUICK BROWN FOX 
THE LAZY DOG'S TAIL WHILE T 
CAN OF CAUIAR WHICH MY AUNT 

l'.'.'e ;n HoectF.u. dm!'. :ht ■-, 



jUMPEO OUER 
E DOG ATE A 
WHO USED TO 
IN CELEBRAT 



ION OF THE CENTENNIAL OF THE OLO^REO COU 
RTHOUSE OH THE CORNER OF WASHINGTON STRE 



RTHOUSE ON THE CORNES 
FT ftHD STATE STRE^. 



Now try the statement 

PRINT "150" 



The computer obediently prints the number 150 on the next line, 
as expected. But type 

PRINT 150 

and the computer again prints the number, without any fuss or 
error message about the- missing quotation marks. In fact, the 
Apple will let you PRINT any number at all without enclosing it 
in quotes. 

Without further study, the Apple can be used as a simple-minded 
desk calculator. 

Try this on your Apple:i 
PRINT 3 + 4 

The answer, 7, appears on the next line. The Apple can do six 
different elementary arithmetic operations: 

1. ADDITION. Indicated by the usual plus sign (+). 

2. SUBTRACTION. Uses the conventional minus sign (-). 

3. MULTIPLICATION. Maiky people use an "X" to represent 
multiplication. This could be confused with the letter "X 1 
Some people use a dot ( ), but this could be confused with a 
period or a decimal poiAt. So the Apple uses an asterisk <*) . 
To find 7 times 8 (in case you don't remember the answer), just 
type 

PRINT 7*8 

and have your memory jogged 
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4. DIVISION. As is customary, use a slash (/). To divide 63 by 
7, type 

PRINT 63 / 7 

and the correct ajnswer will appear. 

Try dividing 3 by) 2. The answer is one and one half. The Apple 
gives the answer to you in the decimal form: J. 5. 

One thing we should point out here is that you can do more than 
one arithmetic operation in the same instruction. For example, 
it is legal to say 



PRIN1 



+ 8 +: w * 4 



The exact rules governing such usage will be given later, but 
you can experiment with it now if you wish. 

6. EXPONENTATIOtf . It is often handy to multiply a number by 
itself a given mjmber of times. Instead of bothering to write 

PR INT 4*4*4*4*4 
you can substitute the shorthand 

PRINT 4 -■ 5 

The upward pointing arrow is typed: 



There is nothing special about exponentiation. It is just an 
abbreviation for .repeated multiplication! In non 
computer-notatioi, this would be written with a superscript 
five, like this: £ 
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APPLESOFTS FORMAT FOR NUMBERS 

Type 

PRINT 45. 340 

Your computer responded with 

45. 34 

and didn't PRINT the trailing zero. The Apple does not PRINT 
leading or trailing zeros, that is, zeros that are at the 
beginning of a number ^nd to the left of the decimal, or zeros 
that are at the end of a number and to the right of the decimal. 

Very, very small numbers (between about 

000000000000000003 and -.{ 

03) will be converted to zero by the Apple. (We hope that was 

the right number of zeios.) An easier way to write these 

numbers is 3 * 10" - 39 and -3 * 10" - 39. Don't take our word 

for it. Try It yourself. 

Now type 

PRINT 985786. 6898 

Surprise! The last two digits are lost, and the number left 
behind is the closest approximation the computer can think of. 
This process is called "rounding". Try typing 

PRINT 788. 6898 

Your computer did not rlound the number, but PRINTed it just the 
way you typed it. Madness you say? Ah, but there is a method 
to this seeming madness. Numbers are rounded only if they have 
more than nine digits. Any number that has fewer than ten 
digits will not be rounjded. The computer does the best it can, 
but it only has nine digits to work with. 

If you type a PRINT statement with a long number like 

1234567890 



the Apple responds with 

i. 23456789E+09 
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The numbers 1234567890 and 1.23456789E+09 have the same value. 
Really. The number PRINTed by your computer is in "scientific 
notation". If ypu need numbers like this you probably know how 
to read them. The Applesoft BASIC Programming Reference Manual 
has more informajtion if you are curious about this strange 
notation. 

Try some more numbers. How many digits can a number without a 
decimal point have before the Apple changes it to scientific 
notation? If scientific notation seems complicated, don't 
worry. You probably won't be wanting to use numbers that 
require it for sbme time yet. Remember that any number will be 
PRINTed just thei way you type it if the number is surrounded by 
quotes. However^ the Apple can't use numbers in quotes for 
arithmetic operations. For more information on scientific 
notation and other types of number formatting used by the Apple, 
refer to the Applesoft II BASIC Programming Reference Manual. 



MORE ABOUT RETURN 



So far, you have been pressing (33E33 after every line, like a 
zombie. We thought we might tell you why this key gets so 
overworked. Thelreason is simple: without the fflflliafl , the 
computer does nop know when you have completed the Instruction. 
For example, you might start typing 

PRINT 4+5 

If the computer immediately jumped in and printed a 9, you might 
be upset because you had planned to type 

PRINT 4 + 5 + 346 

which would have given a different answer entirely. Since the 
computer can't tall when you have finished typing an 
instruction, you must tell the computer. You do this by 
pressing the MillM! key. Since you always have to do this 
after typing an instruction, we have (as you know) stopped 
mentioning QSS3 1 after every instruction. Pressing (jiSUiiuJ 
after each instruction should be a habit by now, if you have 
been doing all tl}e examples. 

We really hope ybu have been trying all the examples. Learning 
to program is very much like learning to ride a bicycle, play 
the piano, or throw a baseball. You can read all the books In 
the world on the subject of bicycle riding, and be a great 
"paper expert." But all this book-learning is of little help 
when you actually get on a bicycle for the first time. Once you 
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have learned to ride, thrjough experience (which can be a bit 
painful), you can go almost anywhere. The same is true of 
programming. You can read this manual and think you understand 
it. But you won't be abl^ to program. Only if you do each 
example, as it is given, i*ill you learn to program. That's the 
truth. 

EASY EDITING FEATURES, 

OR: WHAT TO DO BEFORE YOU HIT RETURN 



No one is a perfect typis 
mean?). The Apple has se\ 
errors, thereby saving yot 
for each goof. This is w\c 
right-pointing arrows on 



. We make mysteaks (Oops! See what I 
eral features that aid in correcting 

the effort of retyping a whole line 
ere the left-pointing and 

e keyboard come in. 



tli 




The ^3 key is rather likfe 
we win call it the "backs]) 
make this clear. Type ( 



the backspace key on a typewriter so 
ace key". A few experiments will 
tly as shown) the statement: 



PRINT COMPUTER" 



and, as usual, press the 



fr,-!aiH;JJI 



key. The computer will reply 



because of the missing quot[e. Now if we had typed 

PRINT "COMPUTER" 

the computer would have responded with 

COMPUTER 

Don't believe this manual. Try it- Now, without pressing 
EaOED » type the "niistakejn" instruction: 

PRINT "COMFUTER" 
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Since you havet, 
As shown in thr 
of the last quot 



't pressed E5H3I , nothing has happened yet. 
photograph, the cursor is sitting to the right 
e. (Sorry, we can't make the photo blink) 




To change 

COMFUTER 
into 

COMPUTER 



we can use the O . Notice that each time you press this key, 
the blinking cursor moves back (to the left) one space. 
"Backspace" is also a verb. So backspace the cursor to the F. 
Type a P. As you see, the P replaces the F. Now press 
fcHaWIAI . You got 



COMP 



from the computer? That is because you backspaced over "UTER" . 
Any character in the line you are currently typing that is 
backspaced ove^ is not sent to the computer when you press 

iiijtui;!. 1 ! . One solution would be to correct the F by backspacing 
to it, and thep to type 
Mb A 



Try it. 

It works 1 Thejre is, however, an easier way. When you press the 
C% key, the cursor moves to the right. As the cursor moves to 
the right across a character, it has the same effect as if that 
character had been retyped. We call the ^^ key the "retype" 
key. Again type 

PRINT "COMPUTER" 
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then backspace to the F and change it to P. To complete the 
correction simply press the retype key five times, and then 
press liiamj . Does it all work? The use of the backspace and 
retype keys will save you a lot of time. Make a point of using 
them a number of time$ on your own "mistakes," so that these 
keys become familiar. 

PUTTING COLOR ON THE SCREEN 



To put color graphics 
which of the 16 avail; 
To specify where a co! 
vertical columns, numl 
leftmost edge of the 
right. You may wondei 
40 instead of throu{ 
experience you will f: 
somewhat handier, evei 



on the screen, we need a way to describe 
ble colors we want, and where we want it. 
or goes, we divide the screen into 40 
ered through 39. The column is at the 
creen, and the numbers increase to the 

why the numbers don't go from 1 through 
h 39. As you get more programming 
nd that the choice we have made is 

though it may not seem that way at first. 




The screen is also divjided into 40 horizontal rows, again 
numbered to 39. The! horizontal rows start with row at the 
top of the screen and increase to row 39 at the bottom. These 
rows cut across the cdlumns, partitioning each column into 40 
"bricks" numbered (tjhe top brick) through 39 (the bottom one). 
Those who like formal terminology will recognize that this is 
merely a system of rectangular Cartesian co-ordinates. Those 
who don't like fancy tjalk can just think in terms of columns of 
bricks. 
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To use the scpreen colorfully, type the following instruction: 



GR 






You remembered the E5HE8 , no doubt. When you use this 
command the screen wipes itself clean, leaving only four lines 
for text at the bottom. The "GR" stands for GRaphics. To get 
back to things as they were (before you typed GR) you use the 
command 

TEXT 

When you type this command the screen will suddenly change to a 
lot of "at" signs (@). This is normal. Try typing the TEXT 
instruction, and then getting back, to graphics by typing the GR 
instruction, i 

Before you caiV place a dot of color on the screen, you must tell 
the computer which color you want. There are sixteen colors 
available. Yqu have seen them before: they are numbered from 
to 15, as shown in COLOR DEMOSOFT 2. 




Suppose you warjt to put a green dot somewhere. You must first 
type the GR command, and then type 

CCLCR = 12 

This means thatl any dot (or spot or brick) of color that you 
place will be gjreen. In fact, until otherwise instructed, 



everything the 
Except, of cour 
the screen for 
upper left-hand 
top or zeroth b 

PLOT ; 



computer puts on the screen will be green, 
se, for the small area reserved at the bottom of 
your instructions. To put a spot of color in the 
corner of the screen (leftmost or zeroth column, 
rick) , you type 
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To put a spot of the same color in the upper right-hand corner, 
you must specify column 39, brick 0. So type 

PLOT 39, 

Notice that you always give the column first. Now put an orange 
brick at the lower left-hand corner. First change the color. 
Remember — you should really be doing these exercises, not just 
thinking about them. $o, put out your fingers and type 

COLOR ■ 9 

Nothing happens on the upper, graphic portion, of the screen 
(even if you did remember to press i:iaiti;ii?i ) . But the computer 
remembers that when yott next PLOT something, it will be in 
orange, not in green. Now that you have chosen the color, you 
can put a dot in the lower left-hand corner. That's column 0, 
and brick 39: 



'LOT 0, 39 






Did it work? Did you tforget to press 
favorite color? 



i^i'.iki ? Is orange your 



Now put a magenta dot 
out for yourself. 



n the lower right-hand corner. Figure it 




PLOT ERROR MESSAGES 



There are two error messages that can easily turn up when you 
are using the PLOT statement. You already know that if you 
typed 

PLAT 
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instead of 

PLOT 

you would get) the message 

7SYNTAX ERF OR 

A new error message occurs when you plot a number higher or 
lower than thjose permitted for coordinates in a PLOT command. 
Type 

PLOT 13, 85 



and you get t 

? ILLEGAL QUANT 



le message 

ITY ERROR 



This message jneans that you have tried to plot a point out of 
range and off the screen. The highest numbers you can use in a 
PLOT statement are 39 for the first coordinate, and 47 for the 
second. Use of numbers over 39 for the second coordinate, as in 
a statement s ich as 



PLOT 20, 45 






will just giv^ you peculiar characters in the text area at the 
bottom of the screen. 

Trying to use negative values in a PLOT command is another way 
to get the 

? ILLEGAL QUANTITY ERROR 

message. 



DRAWING LINES 



Suppose you wglnt to draw a light blue horizontal line from 
column 5 to cqlumn 9 at the level of brick 14. You could type 

COLOR = 7 
PLOT 5, 14 
PLOT 6, 14 
PLOT 7, 14 
PLOT 8, 14 
PLOT 9, 14 



m 



m 
m 
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Notice that the joints between adjacent bricks do not show, and 
they form a continuous line. However, there is an easier way to 
do horizontal lines. There had better be. Suppose you want to 
draw a dark green horizontal line across the middle of the 
screen. Using the long way, it would take forty typed 
statements: 

COLOR = 4 
PLOT 0, 20 
PLOT 1, 20 
PLOT 2, 20 



and so on, until 



PLOT 39, 20 

The easier way is this. Just type 

COLOR, a 4 

KLIN 0, 39 AT 20 

Press the ti£2!liU key, and there you have it: an instant 
Horizontal LINe from column to column 39 at the level of brick 




Now cry to place a purple line from column 19 to column 28 at 
the level of brick 18. Try a few others. Doing about 6 
different horizontal lines should give you the hang of it. 

Notice that when you put a colored dot or line at the same 
location as an existing dot or line, the new color takes over, 
and the old color disappears. To clear the screen of all 
graphics at once, use the GR command. 

There is a provision for automatic vertical lines similar to 
that for horizontal lines. To draw an orange Vertical LINe in 
column 7 from brick 12 to brick 33, we write: 



33 
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COLOR = 9 

VLIN 12, 23 AT 7 

Try this statement. 




m 
* 

ft- 



Practice making several more vertical lines by changing the ■& 

numbers for the rows and columns. You can test your proficiency 

with both horizontal and vertical lines by drawing a magenta ^^ 

border around the screen in five statements. Then put a green |PJ 

cross on the screen. Try drawing some lines with COLOR = 0. 

Play with PLOT, HLIN and VLIN for a while. This manual's Kj 

usefulness to you will self-destruct in five seconds if you 

don't experiment with these commands. Pfffsssss. m 

THE GAME CONTROLS E 

E 
1 



Grab the game control that you used in playing LITTLE BRICK OUT 
With the other hand type 

PRINT PDL.i.0; 

and a number should appear. Move the control a bit. Now type 

PRINT PDL<0, 

again. Experiment with moving the control and typing 



If the number never changes, you've got the wrong game control. C 

What are the highest and lowest numbers you can get? What is 

the smallest change you can make? _ 

e 

34 6 



You can discover the position of the other control by PRINTing 
PDL(l). The abbreviation "PDL" comes from the word "PADDLE" 
since these controls are often used to control "paddles" in 
games. There are many other uses for these controls. 



3 
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PDL is a function . A function, in Applesoft, is something 
that takes one or more numbers and then performs some operation 
on them to yield a single value. The numbers that the function 
uses are called its arguments and are always put in 
parentheses after the function name. PDL is a function that has 
one argument. The number the function finds is said to be 
returned to the program. 



PIGEONHOLES 

AND MORE CALCULATOR ABILITIES 

On many simple calculators you can save a number for later 
reference or use. To do this, you put the number into a special 
place in the calculator — a place we shall call, for now, a 
pigeonhole. Usually this is done by pressing a key marked "M" 
for "Memory." On the Apple you can do the same thing. For 
instance, to save the value 77, you type 

K = 77 

The value, 77, is not printed, just stared in the pigeonhole 
called M. If you now type 

PRINT M 

the computer will print the value of M. Try typing the two 
statements. 



Now type 






and PRINT the value of 11. It is 324, right? What happened to 
the 77? It is gone forever. The pigeonhole can hold only one 
value at a time. When you put a new value in M, the old value 
Is erased. 

Type 

PRINT »M«-- 

What happens? There is a big difference between 



and 
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ft 
fc 
fc 

In one case we are referring to little furry things with long ™— 

tails. In the other case we are referring to the word itself. ^^ 

This is how quotes are used in computerese. When we say Jj 



I 



It is just like the difference between these two statements in 
English: 

MICE HAVE FOUR FEET. 

"MICE" HAS FOUR LETTERS. 



PRINT "M 1: 

we mean to print the letter itself. When we say 

PRINT M 



fc 
fc 

we mean to print what the letter stands for. You would never 

confuse the name of someone you love with the actual person that 

name stands for. (■ 

You can store the result of a computation in a pigeonhole. For ^- 

example: 

M = 4 + 5 fe 

You can see that the answer has been stored by PRINTing the E 

value of M. 



You can also use the value of M in further computation. For 
example, try this on your Apple: 

PRINT M + 2 

Is the answer what you expected? Try some other calculations 
using M. 



fc 
fc 
fc 
fc 



A simple calculator has one pigeonhole. Computers have hundreds 

of pigeonholes (Applesoft has 936). The formal term for 

pigeonholes is variables. But this term is somewhat misleading 

since pigeonholes don't behave like "variables" in mathematics. 

They are much simpler. Each one is merely a place where one Ej 

value is stored. But we will defer to common usage. Just 

forget the math you've learned. In the Apple all variables have 

the value of zero until you put something into them. 



fc 



A pigeonhole, or variable, can have almost any name that you E 

like, so long as it starts with a letter. For example: 

fc 
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SUM = 56 + 34 + 1523 + 8 
GAMEPOINTS - 45 
PLAYER2 = 9 

Some names are not allowed because they include a word that has 
a special meaning to the Apple. These are known as reserved 
words. One of these words is "COLOR". Thus a variable's name 
must not have the word "COLOR" In it. Try typing 

THISCOLOR = 6 
or 

COLORFUL = 9 

All you get for your pains is an error message. Whenever a 
variable name gives you the 7SYNTAX ERROR message, it means that 
you have unwittingly included a reserved word in the name. 
Don't worry. Just choose another name. 

A list of "reserved" words that cannot be used as variables or 
as part of variable names can be found in Appendix B in the back 
of this manual. 

When you are choosing names, make them reflect the use to which 
they are being put. This will make them easier to remember. 

Try typing 

BIRD = li 

and then 

PRINT BIRD 

Did you get what you expected? Now type 

PRINT BITE 

What happens? Try 

PRINT EILL 
and 

PRINT BILLOW 
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If you study the names you will notice that they all begin with 
"BI". Applesoft uses only the first two characters of each 
variable name to distinguish it from other variable names. So 
the name 



fc i 

fe : 



BIRD 




refers to the same variable as 


BITE 


and 




EILLOW 




and so on. 





Here is a useful trick. Let's say that you had some value in 
the variable PRICE, and you wanted to increase this value by 5. 
One way you could do this would be to PRINT the value of PRICE, 
then add 5 to that value, and finally store the resulting value 
back in PRICE. For instance: 

PRICE = 26 
PRINT PRICE 
PRINT 28 * 5 
PRICE = 33 

But see how much easier it is to type 

PRICE = 23 

PRICE = PRICE * 5 

Try the statements on the next page in order: 

PRICE ■ 2 
PRINT PRICE 
PRICE = PRICE + 3 
PRINT PRICE 
PRICE - PRICE * 6 
PRINT PRICE 
PRICE = PRICE / 10 
PRINT PRICE 

At the end of this sequence of statements, you will probably 
have the value 3. Is this correct? Is this what you expected? 
Try this sequence: 



E 
6 



1 
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APPLES = 55 
BANANAS = 11 
QUOTIENT = APPLES 
PRINT QUOTIENT 



/ BANANAS 



First think what answer you expect, then see if you are right. 
If you are not, find out why. Lastly, try these statements: 

HELLO = 12S 
PRINT "HELLO" 
HELLO = HELLO / 2 
PRINT "HELLO" 
HELLO = HELLO / 2 
PRINT HELLO 

What did you expect? What did you get? 

PRECEDENCE, OR WHO'S ON FIRST? 

At certain old-fashioned banquets, the people were served their 
food according to a strict plan: first the guest of honor, then 
the female guests (in order of the rank of their husbands), then 
the male guests (in order of rank), and finally the host. No 
matter where they were seated, the waiter went among them 
choosing the appropriate persons to be served next. We could 
say there was a certain precedence among the diners. In a 
simple calculation like 

PRINT 4+8/2 

you can't tell whether the answer should be 6 or 8, until you 
know in which order (or precedence) to carry out the arithmetic. 
If you add the 4 to the 8, you get 12. If you then divide 12 by 
2, you get 6. That's one possible answer. However, if you add 
4 to eight-divided-by-two, you have 4 plus 4, or 8. This is 
another possible answer. Eight is the answer your Apple will 
give. Here's how the Apple chooses the order in which to do 
arithmetic: 

1. When the minus sign is used to indicate a negative number, 
for example 

-3 + 2 

the Apple will first apply the minus sign to its appropriate 
number or variable. Thus -3+2 evaluates to -1. If the Apple 
did the addition first, -3+2 would evaluate to -5. But it 
doesn't. Another example is 
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BRIAN = 6 

PRINT -BRIAN + 10 

The answer is 4. (Notice, though, that in the expression 5-3 
the minus sign is indicating subtraction, not a negative 
number . ) 

2. After applying all minus signs, the Apple then does 
exponentiations. The expression 

4 + 3 ■'■• 2 

is evaluated by squaring three (three times three is nine), and 
then adding four, for a grand total of 13. When there are a 
number of exponentiations, they are done from left to right, so 
that 



is evaluated by multiplying 2 by itself three times (2*2*2) 
which is eight, and then multiplying that by itself (8). The 
answer is 64. 

3. After all exponentiations have been calculated, all 
multiplications and divisions are done, from left to right. 
Arithmetic operators of equal precedence are always evaluated 
from left to right. Multiplication (*) and division (/) have 
equal precedence. 

4. Lastly, all additions and subtractions are done, from left 
to right. Addition (+) and subtraction (-) have equal 
precedence. 

Let's summarize the Apple's order of precedence for carrying out 
mathematical operations: 

First: - (minus signs used to indicate negative numbers) 

Second: * (exponentiations, from left to right) 

Third: * / (multiplications and divisions, from left to 

right) 

Fourth: + - (additions and subtractions, from left to right) 

Below, you will find some arithmetic expressions to evaluate. 
With each one, first do it in your head (or with the help of a 
hand-held calculator, or pencil and paper), and then try it on 
the Apple. If your own answer is different from the Apple's 
answer, try to find out why. We will give only the expressions 
here. You will have to put a PRINT in front of each one to get 
its value from the computer. 
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Unless you have a lot of experience with the way computers 
evaluate expressions, you should actually do these examples. 
Don't do them all at once and then check with the computer. Do 
an example by hand and then do it on the computer. Then go on 
to the next one, and so on. 



4 + 

5 * 

4 ■'"■ 

6 / 

5 - 

4 / 

6 * 

4 + 



2 + 
4 + 
4 / 
2 - 
-2 
— c 



■-> 



+ 



e / 

8 * 
20 / 



3 
i 






+ 6/3 + 8 
3 + 1 

■ i 



2 / 2 h 
* 5 



* i 






No answers are given in this book. Your Apple will give you the 
correct answers. 



HOW TO AVOID PRECEDENCE 

Suppose you want to divide 12 by four-plus-two. If you write 

12/4+2 

you will get 12-divided-by-four, with two added on. But this is 
not what you wanted. To accomplish what you wanted in the first 
place, you can write 



i< 



(4 + 



The parentheses modify the precedence. The rule the computer 

follows is simple: do what is in parentheses first. If there 

are parentheses within parentheses, do the innermost parentheses 
first. Here is an example: 

12 / (3 + ( 1 + 2) "• 2) 
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In this case, doing the innermost parentheses, you first add 1 + 
2. Now the expression is, effectively, 

12 / (3 + 3 m 2> 

But you know that 3 + 3 " 2 is 3 + 9 or 12 so the expression has 
now been simplified to 12 / 12, which is one. 

In a case like (9+4)* (1+2), where there is more than one 
set of parentheses, but they are not "nested" one inside the 
other, you just work from left to right. This expression 
becomes 13 * 3, or 39. 

Here are some more expressions to evaluate. Again, if you are 
not familiar with computers, the few minutes you spend actually 
working these out and trying them on the Apple will be very 
valuable. You will be well repaid for your efforts by being 
able to use the computer more effectively. Incidentally, most 
of these rules for precedence and parentheses hold good for most 
computer systems anywhere in the world, not just the Apple. 

44 / (2+2) 
144/51+2 

3 + (-2 * 2/ 

(3 + -2) * 2 

1 00 / ( 200 / ( 1 t (9 - 5 ) ) ) 
32 / ( 1 + ( 7 / 3 ) + ( 5 / 4 ) ) 
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Deferred execution: NEW, LIST, RUN and HOME 

Elementary editing: DEL 

Elementary aerobatics: GOTO loops 

Some more things that make life easier: more editing tips 

The moving cursor: editing with the ESC key 

A word about learning Applesoft BASIC 

An accident about to happen 
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Saving programs on diskette: SAVE, CATALOG, RON and LOAD 

Saving programs with a cassette recorder: SAVE 

More graphics programs: REM 

FOR/NEXT loops 

A wrong program 

A last example of nested loops 

Getting flashy: INVERSE, FLASH and NORMAL 

PRINTS charming; comma, semi-colon, TAB, HTAB and VTAB 
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DEFERRED EXECUTION 



No, this section is not on last minute reprieves for condemned 
criminals. Up to now, when you typed 

PRINT 3 * 4 

and pressed the 1:1a jl 1:1 Jl key, the computer would do what you 
told it to do, immediately. When a computer performs according 
to the statement you have given it, it is said to execute that 
statement. Thus, you have been using the computer to do 
immediate execution of each statement you have typed on the 
Apple's keyboard. 

You are about to learn how to store statements for execution at 
a later time ( deferred execution ). To make sure that the 
computer's memory is cleared of any previous programs, type 

NEW 

Like almost everything else you have seen, NEW has to be 
followed by a naniMi . To tell the computer to store a 
statement, just type a number before typing the statement. For 
example, if you type 

100 PRINT 3 + 4 

nothing seems to happen, even if you press rrarit-Jfl . The Apple 
has stored the statement. To see that it has stored the 
statement, you type the instruction 

LIST 

Try it. Unless you mistyped something (and probably got a 

^SYNTAX ERROR 
for your effort) , 

100 PRINT 3 * 4 

appears on the screen. Now type the statement 

9. UN 

and the answer 



appears on the screen. 






?i 
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Typing RUN caused your stored statement to be executed, but the 
computer has not forgotten the statement. You can RUN the same 
statement as many times as you like. Try it. 

What's more, the computer does not forget the stored statement 
when you clear the screen. Here's a new way to clear the 
en: 



HOME 
' *Hie HOME command has the same effect as 



that you learned earlier, but it can be used in deferred 
execution as well as immediate execution. To try this out type 

100 HOME 

Now when you type 

RUN 

the computer faithfully executes the stored statement and clears 
the screen. Type 

NEW 

and then 

LIST 

and see what happens. Typing NEW has caused the stored 
statement to be lost permanently. Type 

RUN 

and nothing appears on your screen. That is because your old 
statement has been erased by the NEW command. 

It is possible to store many statements by giving each of them a 
different number. Try typing this: 



,: m;~; : n< 



PRINT 67 
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Nothing much has happened so far. But now type 

RUN 

and watch the answers appear. 







The numbers that we put in front of statements, in order to tell 
the computer to store them, are called line numbers . The 
computer stores and executes statements in order of increasing 
line number. To see this in action, erase the statements you 
stored by typing 



and then type these statements: 

PRIMT iL F L - 

PRINT "6 :: 
3 PRINT "E'j 

Notice that zero is an allowed line number. The highest line 
number that you can use is 63999. Now RUN these instructions. 
The results should look like this: 



F 

• - 
F 



To see what has happened inside the Apple, type 



Notice that you do not have to LIST a set of instructions before 
you RUN them. It is, however, a good idea to do so. 



1 
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A set of instructions that is executed when you type RUN is 
called a program . 

The program was meant to print 



A 
F 
P 



but, it seems, a PRINT statement was left out. How can you add 
it in? Only by retyping the statements with line numbers 2 and 
3 as statements 3 and 4, and adding a new line number 2. To 
make the corrections type this: 

2 PRINT "P" 

3 PRINT : 'L" 

4 FRIWT "E" 

To see what has happened, LIST the program. 

Notice that in whatever order statements are entered, the Apple 
stores them with their line numbers in numerically ascending 
order. Now RUN this program. 

It was a bother to have to retype those statements in order to 
merely add one in the middle. It is, therefore, good 
programming practice to leave some line number room between 
lines, and before the first line. Type 



to eliminate that program and put in this one: 

iM PRINT ,: C' 

iiZ ; PRINT ;i T r 

When you RUN this program it doesn't quite print the word "CAT" 

vertically. But now you can go back and type 



105 PRIftfT "A ' 

LIST and RUN this program. From now on this book will start all 
programs at a reasonably high line number and leave plenty of 
room between successive line numbers so there will be adequate 
room for inserting statements. 
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ELEMENTARY EDITING 

Earlier, you discovered that the instruction 

PRINT FDL(0; 

would print a number corresponding to the present position of 
one of the game controls. It took quite a number of PRINTs to 
discover very much about the control. Now that you can write 
programs, life is much easier. Clear the computer with a 

NEW 

and type 

100 PRINT Pl;L(0) 

Now, each time you type RUN, this short program is executed and 
you can see the position of the game control. 

For doing something more than once, the stored program is 
already saving you some work. Before, you had to retype a whole 
statement or group of statements. Now, you merely retype 

mm 

Deferred execution confers another advantage. You can modify 
part of a program and leave the rest the same, without having to 
retype the whole thing. For example: 



200 P = PDu 10) 

2i£ PRINT P 

220 PRINT U MDVE THE GAME CONTROL " 

230 PRINT !; TG A NEW POSITION' 1 

RUN this program a few times, changing the game control's 
setting between RUNs. Check to see if the program responds to 
both game controls. It should work for only one of them. You 
might take this opportunity to mark this control with the number 
zero. 

This same program can be used, with a slight change, to look at 
the other game control. List the program the way it is now, 
then type 

2|59 P = PDl. * I ) 
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When you type a statement with the same line number as one that 
already exists in a program, the new line replaces the old one. 
LIST the program to see how it has changed. RUN it a few times 
to see what happens. Move the other game control between RUNs . 
Does this program respond to both controls? Mark a number one 
on the control to which this program responds. 

Modifying a program in this way is one example of editing a 
program. Another way is to use what you have just learned to 
delete lines you no longer want in your program. If you wanted 
to erase line 230 in the preceding program you would type 

230 



and then press 



To DELete line 



You could also have used the DELete instruction. 
230 from your program you would type 

The advantages of the DELete are not apparent until we reveal to 
you that whole sections of programs can be erased with 
instructions like 



}£.L 20i 



532 



which DELetes every statement whose line number is 200 or 
greater, but less than or equal to 230. Try these commands, and 
LIST the program to see what they do to it. The ability to 
DELete blocks of line-numbered statements will be handy when you 
are writing large programs. 

As you have seen, there are several commands that help you deal 
with whole programs. They are 



which erases programs, 



which displays programs, and 



'-■•■■ >■■■'-. 



which executes programs, beginning with the statement having the 
lowest line number. It is also possible to start execution 
elsewhere, and to LIST only part of a program. These 
capabilities will be covered later. 
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ELEMENTARY AEROBATICS 

At this point you are beginning to fly, so this section will 
discuss loops. 

The best way tb see how the PDL function works — and to 
understand program "loops" — is to use a statement we haven't 
discussed, until now. It's very simple. Type the following 
lines (after typing NEW, to erase any old programs that might be 
around) : 



fc ; 






1 1 & 

120 



PRINT PDLC0) 
GDTG life 



Line 110 of this program PRINTs the number representing the 
current value of the game control. Line 120 does just what it 
seems to say: it causes program execution to go to line 110. 
What happens then? The program PRINTs the current value of the 
game control. Then it executes line 120, which says to do line 
110 over again, and so on. Forever. This is a loop . A loop 
is a program structure that exists when the program includes a 
command to return to a statement executed previously. RUN the 
program. Play with the game control. In the next section, we 
will tell you how to stop this program. Meanwhile, admire the 
fact that — if you typed RUN when instructed to do so, three 
sentences back — your Apple has executed the statement PRINT 
PDL(0) a few hundred times already. Now the power of a stored 
program begins to increase significantly over what you can do by 
hand. Your abilities with the computer will increase 
dramatically in the next few sections, now that a good 
groundwork nasi been established. 

SOME MORE THINGS THAT MAKE LIFE EASIER 

But first, you 1 are probably wondering how to stop the paddle 
program. You have already noticed how the numbers ripple up the 
screen as you move the paddle. This is because the numbers are 
printed at the bottom of the screen and as each new number is 
printed, all the rest of them are moved up one line. This is 
called "scrolling" and you've been seeing it all along, but at a 
much slower rate. To stop running the program, simply use 



The HEW Q command lets you know where the program execution 
was stopped by printing 
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or whatever line number the program was stopped at. (Try it). 
B y the way, this is art exception to the r ule ab out pressing 

liiaUSJ after every command. Pressing laai.'.Mi is usually not 
necessary when a pr ogram is stopped with EEB B . You can 
a lso u se the GEH kjey to stop programs if you like, but, with 

EBP you will not get the message that tells you the line 
number at which the program was stopped. 

When you stop a program with HD or fflB , you can 
resume its execution by typing the instruction 

which stands for "CONTinue." Try it, and then try this program: 






MEW 

100 X ■ PDL(0< 

110 PRINT "GAME CONTROL ZERO IS" 

120 PRINT X 

130 V = PDL< 1 > 

140 PRINT "AND CONTROL ONE IS" 

150 PRINT V 



Earlier we said that when you type RUN, the program starts 
executing at the lowest numbered line. True. However, if you 
want to start RUNning at some other line, such as line 130, you 
simply type 

RUN 130 

You can specify line numbers in the LIST statement, as well. If 
you type 

LIST 130 

the Apple will LIST line 130 <if there is one, of course). . If 
you type 

LIST 1 1 . 130 

the Apple will LIST all the lines of your program starting at 
line 110 and continuing through line L30. This feature is not 
available with the RUN instruction. 
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THE MOVING CURSOR 
HAVING WRIT 
CAN ERASE OR COPY 
ANY OF IT 



When the backspace and retype keys are pressed, they move the 
cursor. But they also either erase or retype characters, as you 
learned in Chapter 2. It is possible to move the cursor without 
affecting anything at all (except the cursor position). You do 
this by using pure cursor moves . 

Five keys are used in executing pure cursor moves. They are: 
1^3 > O » f] , 13 , and E . Here's how to use them. 
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First you put the Apple in edit mode by pressing and releasing 
the E3 key, then use Q to move the cursor up, to move 
it left, to move it right, and f, to move it down. To move 
the cursor repeatedly, hold down one of the cursor direction 
keys ( O , D, ' 3 > °r CD) and then hold down the ^ key 
at the same time. The cursor will zip along while both keys are 
held down. If the cursor reaches the top of the screen, it will 
stop. If the cursor reaches the bottom of the screen, it will 
stop, and the screen display will move upwards, one line at a 
time. If it reaches the right edge of the screen, the cursor 
will disappear and "wrap around" to the beginning of the next 
line. Practice moving the cursor around the screen with these 
five keys. 

When you get tired of pure cursor moves just press the space 
bar, and you will find yourself in normal typing mode. 

The pure cursor moves caused by the and keys, v/hen seen 
on the screen, appear the same as the moves caused by the 
backspace and retype keys, but the effect is different as you 
will see when you LIST the results. The pure cursor moves don't 
cause any changes in the text they go over, whereas the 
backspace and retype keys erase and retype the characters they 
go over. 
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These pure cursor moves do have an application, so they are not 
so pure after all. For example, type: 



.20 
.40 



!-h. UN | 

PR INI 



"THE qua; 
: T ^i NOT g 



TV of h^r? ; : 



pressing lirqiTT^i after each line. Your Apple seems to accept 
the statements, but when you try to RUH the program, you get the 
message 



''SYNTj 



for your pains. 



in taj 



To make the needed correction you can use this trick to 
effectively retype the entire statement. First LIST the program 
and then press (23 • Now type fj enough times to move the 
cursor up to the line with the incorrect statement. Press the 
{} key to move the cursor to the beginning of the line, and 
then use the retype key to retype all the characters preceeding 
the "U" in "PRUNT". Type an "I" over the "U", and continue with 
the retype key to the end of the line. Then press ItlatMJI and 
LIST the program to see that the line is properly corrected. 
The computer does have mercy on poor typists. 

When you must retype a portion of a line that appears somewhere 
on the screen, the pure cursor moves and the backspace and 
retype keys can be used to speed the retyping. A few minutes of 
playing with this feature now will save you much work later. 



The backspace key only works on the line you are currently 
typing. If you type a program line and then execute a pure 
cursor move before you press i^ii^i , the program line you just 
typed, not the characters the backspace key is going over, will 
be affected by the backspace key moves. The retype key, 
however, does retype the characters it actually goes over. 

A WORD ABOUT LEARNING 
APPLESOFT BASIC 

Many times there are questions you can ask about the Applesoft 
BASIC language that are not answered directly in this book. For 
instance, in the statement 
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PRINT "HELLO" 

do you have to put a space after the word "PRINT"? Rather than 
give you the answer, we recommend that you simply turn to your 
Apple and try it both ways. Usually a simple experiment will 
answer your question and, since you have taken the time to try 
it yourself, you will remember it far better than if you had 
merely read it. 

AN ACCIDENT ABOUT TO HAPPEN 

Earlier in this 1 chapter you learned to delete a line by typing 
its line number 1 and pressing the ~fH%) . This is a favorite 
way of introducing errors into your program. Suppose you wanted 
to eliminate line .1100 from your program, but you slipped and 
typed 

110 

l;li«ll:lijl • Congratulations, you have just wiped out line 110. 
This happens. Or you are about to fix up line 450 so you type 

and think about it and decide not to change the line after all. 
Don't press ETfffi'jU P . Either backspace over the line number, or 
use the special "forget this line" command, 






Using fffpW |3 places a backslash at the end of the line you 
are typing, and it will be as if you never typed it at all. 



--- — _ — 
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THE TRUTH 



The Apple can distinguish between what is true and what is 
false. Since this is more than most of us can do, a few words 
of explanation are in order. The symbol > means "greater than 11 . 
The assertion 6 > 2 (which is read "six is greater than two") 
is certainly true. The Apple uses the number 1 to indicate 
truth. 



If you type 

PRINT 6 > 2 






the computer will reply with a one. The assertion 55 > 78 is 
false. The Apple uses the number to indicate falsehood. If 
you type 



PR INI 



the computer will reply with a zero. 

The symbol < means "less than", and you can make statements 
using it as well. Here is the full set of symbols used in 
making assertions: 

> greater than 

< less than 

= equal to 

>= greater than or equal to 

<= less than or equal to 

<> not equal to 

To type the symbols for "greater than or equal to" and "less 

than or equal to" on your Apple keyboard, you must first type 

either a < or a > and then type an =. To type the symbol for 
"not equal to" you must type a < and then a >. 

Think about and then test to see which of these assertions are 
true, and which are false. 



9534 a 435? 
5 ■'. B 
a 5 >= -4 

-6 "C _ / 
-2 >= -5 
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Assertions can include variables and expressions as well as 
numbers. For example 



PRINT (45 * 



(45 



will print tbe value 1 since 270 is not equal to 51 (remember 
that 1 means the assertion is true) . 

You have seen that the Apple can tell truth from falsehood in 
simple assertions about numbers. However, an assertions such as 
ABLE > BAKER, may be true or false, depending on the value of the 
two variables, ABLE and BAKER. If 

ABLE = 5 

and 

BAKER = 9 

then the assertion 

ABLE > BAKER 

is false. But if 

ABLE = -8 

and BAKER = -15 

then the assertion 

ABLE > BAKER 

is true. 

Assertions have the numerical values of zero or one. They can 
be used in arithmetic expressions instead of ones and zeros. 
For example, 

PRINT 2 + (4 ;■■ 2; 

will print the value 4. The statement 

T = 4 O 3 

gives T the value 1, since 4 does not equal three, and thus the 
assertion 4 <> 3 has the value 1. The statement 

HGT = 67 = ife 

looks very confusing at first, but it is easily understood. 
Since 67 does not equal 19, the assertion 67 * 19 is false and 
has the value zero. The value of is given to the variable 
"HOT . " 
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As we have seen, the Apple uses 1 to mean true, and to mean 

false. If something is not true, it is false. If something is 

not false, it is true. This may not always be the case in real 

life, but it is always the case with computers. Try this on the 
Apple: 



PRINT NOT 1 
and then try 
PRINT NO( 









The computer agrees: not true is false and not false is true. 
Of course, you can use expressions instead of ones and zeros. 
For example 









The sentence 

TRIANGLES HAVE THREE SIDES. 

is true. And the sentence 

THIS BOOK IS IN ENGLISH. 

is true. Consider the sentence 

TRIANGLES HAVE THREE SIDES AND THIS BOOK IS IN ENGLISH. 

Is this sentence true or false? It is true. Consider the 

sentence 

TRIANGLES HAVE EIGHT SIDES AND THIS BOOK IS IN ENGLISH. 

This sentence, as a whole, is false. Lastly, consider the 

sentence 

TRIANGLES HAVE EIGHT SIDES AND THIS BOOK IS IN SWAHILI. 

This sentence is also false. In general, when you combine two 

sentences, or assertions, by joining them with the word AND, you 

find that 



a. The new sentence is true if both original sentences were 
true. 

b. The new sentence is false if at least one of the original 
sentences was false. 

The Apple knows how to determine whether an assertion containing 
the connecting word AND is true or false. Test your computer 
with the following instructions; try to predict each answer: 



PRINT 


i ftNE : 








^RINT 


i AND 








" ,"; - x t 


AND i 








PRINT 


AND 






PRINT 


(3 > 2) 


■■-, ■.-.■: "■■ 





PRINT 


(NOT 0) 


AND 


I 


■ 



■ 5) 
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Is this sentence true or false? 

A TRIANGLE HAS THREE SIDES OR THIS BOOK IS IN LATIN. 

It's true. A triangle does have three sides, even if this book 

isn't in Latin, so the sentence as a whole is true. Quod erat 

demonstrandum. In general, when you combine two sentences by 

joining them wit^h the word OR, you find that 

a. The new sentence is true if one or both of the original 
sentences were true. 

b. The new sentence is false if both of the original sentences 
were false. 

The Apple can also determine if an assertion containing OR is 
true or false. Try each of these on your Apple — after figuring 
out what the answer should be. 

PS INT 1 OR 1 

PRINT 1 OR 

PRINT OR 1 

PRINT OR 

PRINT (4 C> 5; OR (4=5) 

PR INT i OR ( £ AND 1 3 

PRINT ((3 > 4) OR (54 < 337); AND (NOT 0) 

AND, OR, and NOT| will become very useful in the next section. 

You have already found that in the statement 

PRINT \ OF i- 

the computer regards 1 as true and as false. Now try this: 

PRINT 23 OR a 

and this: 

PRINT -247 AND 37:707.61 

In assertions, the Apple regards not only 1, but any number 
which is not zero, as true. However, when the computer figures 
out the value of an assertion, that value will always be either 
or 1. 

While the following box gives the precedence rules for AND, OR, 
and NOT, we strongly recommend that you use parentheses to make 
your statements clear. 
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ORDER OR PRIOEDENCE 
FOR OPERATIONS USED 
SO FAR IN THIS TEXT: 



1. 


( ) 


2. 


NOT 


3. 


- 


4. 


* 


5. 


+ 


6. 


> 


7. 


AND 


8. 


OR 






- (for negative values) 



THE IF STATEMENT 



Suppose you want to print out integers from 1 through 
number to a line. An obvious way to do this is 

NEW 

210 PRINT 1 

220 PRINT 2 

230 PRINT 3 

and so on. But this would require 10 statements, and if you 
wanted to print the integers from 1 through 200 this way, it 
would require 200 statements. Using what you have already 
learned, you can PRINT integers from 1 on up in just four 
statements by using a loop: 

im N - 1 

2Vi PRINT N 

22* N * N + - 
230 GOTO 21J8 

There is a way to control how long a loop runs. What you want 
is a statement that does a GOTO if N is, for example, less than 
11, but doesn't do the GOTO if N is greater than 11. The answer 
to your wishes is the IF statement. If a condition is met, the 
computer will skip the GOTO instruction and execute the 
instruction on the next line. If there is no next line, the 
program will end. 

Here is a program that counts from 1 to 10 and then stops: 



2.$% ft = 1 

2\Z PRINT N 

220 N » N + J 

23£ IF N C 10 THEN GO" 
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In general, the IF statement works like this: 
IF arithmetic expression THEN any statement 

First, the arithmetic expression is evaluated. If it evaluates 
to zero (false) all the rest of that program line is ignored, 
and the computer goes on to the next line. If the arithmetic 
expression is not zero (true) the remaining portion of that 
program line is executed. 

The IF statement is a very powerful one, and it will appear in 
almost every program you write. For the fun of it, try this 
program: 



NEU 






400 GR 




410 ROW = 1 




423 CGLCFt = 


ROfc 




*30 HLIN 0, 


3? AT ROW 




440 ROW - RC 


\tt + i 




450 IF ROW 


: 1c THEN 


GGTC 42 



SAVING PROGRAMS ON DISKETTE 

(Skip this section if you are not using a disk drive.) 

At this point, you may wish to save on diskette some of the 
programs you have been using. Simply type in the program (after 
typing NEW) and then type 

SAVE 

followed by the name you want to use when refering to the 
program, and then, of course, a E32ffi| . For instance, if you 
wanted to SAVE the program above and call it STRIPES, you would 
type 

and the program would be saved on the diskette under the name 
STRIPES. Once the program is SAVEd, type 

CATALOG 

followed by EU to see the name of your program listed with 
the other programs on the diskette. You would then be able to 
RUN the program called STRIPES from that diskette anytime you 
wished by typing 
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Try SAVEing the program of your choice. If you accidentally 
mistype the command (and probably get ?SYNTAX ERROR from the 
Apple) simply retype the line correctly. 

Sometimes it is desirable to load a program into the Apple's 
memory without actually RUNning the program. For example, you 
may wish to modify the program before you RUN it. The LOAD 
command is useful in this instance. To use it, simply type 



followed by the name of the program you wish to LOAD. For 
instance if you wanted to LOAD the program called STRIPES, you 
would type 



If you change the program and then wish to RUN the new version 
which is in the Apple's memory but not SAVEd on the diskette, 
remember to type only 



If you forget and type 



the old version stored on the diskette will be re-LOADed, 
erasing the new version in memory. 

You can use the LOAD and SAVE commands to move programs from one 
diskette to another by LOADing a program from one diskette and 
SAVEing the program to another diskette. PractLce using the 
LOAD and SAVE commands. 

SAVING PROGRAMS WITH A 
CASSETTE RECORDER 

(Skip this section if you are not using a cassette recorder.) 

To SAVE on cassette tape a program you wish to use later, first 
insert a blank cassette into your recorder and rewind the tape 
to the beginning, where your recorded program will be easy to 
find. On the recorder, hold down the PLAY lever while pressing 
down the RECORD lever. Both should stay down. Back at the 
Apple, type 
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When you press fciSirtKa , the blinking cursor will disappear. 
After 10 or 15 seconds, the computer will give a "beep" to let 
you know the recording has begun. Another "beep" will sound 
when the recording is completed, and the cursor will reappear. 
Push the STOP lever on the recorder, rewind the tape to the 
beginning, and you are ready to go back to programming. Your 
program in the computer has not been affected in any way by 
SAVEing it. 

MORE GRAPHICS PROGRAMS 

Earlier, you put four colors at the corners of the screen. Now 
type this program: 



i«?fl OR 

2\2 PLOT 0,$ 






LIST the program to check that you typed it in correctly, and 
then RUN it. Quick, isn't it? To change the colors, just 
change line 200, and RUN the program again. Try to LIST the 
program. Notice that the listing slips through the narrow 
window at the bottom of the screen. This will continue to 
happen unless you type 

to get out of GRaphics mode before you try to LIST. 

The following program makes the entire screen a solid color. 






253 IF COLUMN < *0 THEN GOTO 13? 

Here's a blow-by-blow explanation of what happens when you RUN 
this program. Line 200 sets GRaphics mode. The color is chosen 
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in line 210. The program is to start in the screen's column 
and work its way over to column 39. Line 220 makes sure the 
program starts in column 0. At line 230, a vertical line is 
drawn in column 0. Now that column is filled with the desired 
color, line 240 increments the column by one. The value of 
COLUMN is now 1. Line 250 checks to see if the new value of 
COLUMN is less than 40. If it is less than 40, the program goes 
back to line 230 to draw a new vertical line in. that column. 
However, when the value of COLUMN reaches 40 (on the Apple 
screen, the rightmost column is column 39, the program does not 
go back to line 230, but "drops through" (as we say) and stops 
executing because it has reached the end of the program. 

To eliminate the need to type RUN each time you wish to fill the 
screen with color, type 

260 GOTO 210 

Observe what happens. When will this program stop? LIST the 
program and make sure you understand what it does before going 
further in this book. 

When you are finished playing with the solid color program, 
clear the computer and try the following program. It uses a new 
and very important instruction: the REM statement. "REM" stands 
for "REMark". This statement allows you to put commentary in a 
program. The computer ignores any REM statements; they are 
strictly for the benefit of humans. See how easy it is to 
follow this program where REMs are used liberally. 



2m REM SET GRAPHICS MODE 

210 GR 

220 REM CHOOSE A COLOR 

230 COLORE 1 

740 F.EM READ PADDLE ZERO 

250 X = PDL<0> 

2t-0 REM DIVIDE fiV 7 SO MAXIMUM VALUE OF X IS 36 

270 X = V / 7 

280 REM READ PADDLE ONE 

2^0 Y = PDL ( X ) 

300 REM LIMIT RANGE TO KEEP Y ON THE SCREEN TOO 

710 V = Y / 7 

220 REM FLOT THE POINT 

2 30 PLOT X: Y 



34# 



^ n i" n 3 



After you type RUN, operate the game controls. This program is 
called the "Etch-a-sketch" (TM) after a device that behaves 
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similarly. The division by seven is necessary since the PDL 
function gives values between and 255, whereas the screen can 
only accept column and row values from to 39. Dividing by 
seven gives you values from (0 / 7) = to (255 / 7) = 
36.4285715. Then GRaphics mode automatically rounds coordinate 
values down to the nearest integer whose value is less than or 
equal to the given value. In other words, the X and Y 
coordinates are rounded down to integers from to 36 so that 
the X and Y coordinates -can be PLOTted. This method does not 
utilize the full height or width of the screen. To get the full 
width of the screen, instead of 



you could use the two lines 

273 >i = '*- { £■ 

To get the full height of the screen, you could do the same 
thing using the Y coordinate. 

The IF statement limits the value of X to 239. In the Apple's 
low-resolution GRaphics mode, 239 / 6 is rounded down from 
39.833333 to 39. This use of the IF statement to limit the 
range of a variable is very common. 



FOR/NEXT LOOPS 



Loops, whether executed by airplanes or computer programs, have 
a top and a bottom. In the program 



im NUrtBEH = % 

110 PRINT NUMBER 

120 NUMBER =J NUMBER 4 | 

130 IF NUMBER O 12 THEN GOTO 11# 

line 110 is the top of the loop, and 130 is the bottom . The 
program prints the integers from to 12 inclusive. The number 
12 is the limit of the loop. Another way to write a loop is 
to use a statement we have not discussed yet: the FOR statement. 
We can use this statement to rewrite the previous program. 

2m FOR KUM&EF = ib TQ 12 
Sljg PRINT NUMBER 
220 WEXf NUMBER 
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Use 



I 
I 

I 
I 
I 

1 
1 
1 
I 
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I 

I 



RUN 200 

to execute this program. If you just type RUN, the program at 
line 100 (the lowest line number around) will be executed. 



Line 200 contains the new FOR statement. It starts by setting 
NUMBER to the value 0., This is exactly the same task that line 
ine 210 is executed. The bottom of the 

The variable NUMBER is increased by 1 
he upper limit specified in the FOR 
ER is not over the limit, execution 
ent immediately following the FOR. If 
e limit, the program drops through (out 



100 performed. Then 
FOR loop is In line 2 
and then compared to 
statement: 12. If 
continues at the stat 
the variable is over 



of the loop) to the statement after the NEXT. In this case, the 



and, not finding any more lines, 



program drops through 
terminates the prograd 



The most obvious advantage of the FOR/NEXT method of 
constructing loops is that it saves a statement. The most 
important advantage is that you don't have to think so hard when 
writing a loop if you use a FOR/NEXT loop. If you wanted to 
draw a series of horizontal lines on the screen, using each of 
the 15 colors on the screen, you could type 



"1 U i 5 



AT H 



Another advantage is tpat it is much easier to read a single FOR 
statement than to look through three statements to figure out 
what a loop is doing. To find the bottom of a FOR/NEXT loop, 
all you have to do is look for a NEXT which has the same 
variable as the FOR. 



20m 


GR 


3012 


FOR N = 


3220 


COLOR = N 


2030 


HLIN 0: 39 


20^0 


vEV.T .n 



mehtio 



It might be well to 
the FOR statement work£ 
add any new abilities 
some programs easier cfc 



II, you should remove 
3000 and 3040, inclusi 

!)£■■_ 20?0 : 304(5 



m that, although you should know how 
you don't have to use it. It doesn't 
o those you already have. It just makes 
write (for some people). 



At this point, if you have been following along on your Apple 



:he portion of the programs between lines 
re. So type 
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and then LIST the program to check the results. 

To PRINT just the even numbers from to 12, you could use the 
program 



3 

. : 



; 



r 



THIN 

> i _ §QXO 






The secret is in line 120, where 2 is added to THING. We say 
that the loop steps by two. To step by two in a FOR loop, you 
would type 



e 



STEF 



the 



The rest of 
the previous 
changed, 
STEP may be an 
STEP backward, 



page 
wherever 



program would look like lines 21 (J through 220 on 

except that the name NUMBER would have to be 
_ it occurs, to the name THING. Try It. The 
y number in the range of the Apple. It can even 
for example 



T 



X 15 STEF -3 



Type this line and try it by typing 

You should plaV with the FOR statement for a while, if you wish 
to learn to us a it. A number of the example programs from this 
point on will jse the FOR statement. 

Along with the' convenience of the FOR statement come some 
limitations. For example, FOR/NEXT loops may be nested, but may 
not cross. Here are a few examples which demonstrate the idea. 











. 




' 


















. 
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This program is an example of two-level nesting. Think about it 
and RUN this program before going on to the next. Remember, 
when writing programs )tising FOR statements, each FOR must have 
a matching NEXT . 



A WRONG PROGRAM 



. : FOP F\i - 10 TO 

510 PRINT ;■• 

520 FOR J = 30 TO 

53# PRINT •_ 



550 NEX ' . — — 



20* 



%$ 



3 






This program won't worlf 
gives an error message 
you find yourself writ 
gotten tangled. If you 
and still want to cross 
statements. You can c 
will do you. 



Its loops are crossed, which not only 
but doesn't make any sense. Whenever 

^.ng crossed loops, your thinking has 
are sure you know what you are doing, 
loops, use loops made with IF 

ross those all you want, for what good it 



A LAST EXAMPLE OF NESTED LOOPS: 



35jS 

■ 

330 



GF 

--■ £ 
I COLUMN = £ 



TO 30 STEP 10. 



FOR LINE = 
HUE «= HKJS + 
IF HUE ■ 

R = HUE 
RObi = LIHE 

i ' 



.1N£— * 
. 



TG 35 STEP 



' 



TO LINE -r ~ — 
_UMN t 4 AT RQ 



This program has three-Uevel nesting and draws quilts. Note 
that COLOR can't be usdd as a FOR/MEXT variable. COLOR is a 
reserved word in Applesoft. Try running the program in text 
mode by removing line 300. What happens? 
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GETTING FLASHY 



If you're borfed with plain old white print on a black 
background, you will especially enjoy this section. Type 

INVERSE 

and take a look at the Applesoft prompt and cursor. The prompt 
character sholild be black on a white background. Now type a 
simple prograji such as 

NEW 

100 PRINT "BLACK AND WHITE IN COLOR" 

and RUN it. |sn't that more exciting? Now type 

FLASH 

and RUN the program again. Now that is. flashy. 



Notice that 
output. Char 
are not chang 
and deferred 
INVERSE and F' 
white on blac 
prefer white 

NORMAL 



FVERSE and FLASH affect only the computer's 
icters which appear on the screen as you type them 
id. These commands can be used in both immediate 
Execution. Experiment with them. After using the 
lSH commmands for a while you may decide that 
is not so boring after all. If you do decide you 
^n black » type 



to return to i|ormal text mode. 

PRINTS CHARMING 

As an experiment, type this program and see what it does when 
you RUN it. 

NEW 

100 PRINT "HELLO" 

110 GOTO lp$ 



Stop the prog it am with tffTH 
one symbol 

100 PRINT "HELLO", 



Then change line 100 by just 
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and RUN the program again. As you can see, this PRINTs the word 
in columns. Now substitute a semicolon (;) for the comma (,) 

\m PRINT "HELLO'S 

and RUN the program again. This time the output is packed . 
This means that there are no spaces between what you told the 
computer to PRINT. It prints HELLO after HELLO, until the 
screen is quickly filled. 

Change the program by adding this statement 

90 V = 99 

and changing line 100 ito read 

100 PRINT V 

RUN this program. Nowj change line 100 to 

\m PRINT v, 

and RUN it again. Theh change line 100 to 

\m PRINT v; 

and observe that the comma and semicolon can also be used with 
numerical values. The ability to place numbers one after the 
other without intervening spaces is sometimes quite useful. 
Commas and semicolons can be used within a PRINT statement. 
Clear the old program yith NEW, and type 

\m STRIDES = 2 

110 BALLS = 3 

120 PRINT STRIKES, EALLS 

You can make clearer output by including messages in the PRINT 
statement. For example* change line 120 into 

120 PRINT U THE STRIDES AND BALLS ARE " ; STRIKES. BALLS 

Notice that you probabljy want to have a space after the word ARE 
lest the number of strikes gets printed too close to it. If you 
don't think that the lajrge space between the number of strikes 
and balls looks nice, you could use the statement 



L2? PRINT "THE STRIKES AND EAi_LS ARE 
■ D-Lu.S 






', STRIDES; 
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In this version, a blank is put between the numbers of strikes 
and balls. P4rhaps the prettiest way of doing this (are you 
trying all of these on your Apple?) is 



150 PRINT 'STRIKES "; STRIKES &As_;. 

This gives you 1 a scoreboard-like display. 



. 



Let's say that you wanted to PRINT the word HEPvE starting in the 
10th column (the screen is 40 columns across, by the way), you 
could use this! statement 



120 



HERE 1 



(You have to tjake our word for it that there are nine blanks 

before the worjd HERE). Or you could use the TAB feature. Just 

as on typewriters, you can set a tab on the Apple. The 
statement 

13* PRINT TAB Uj&> " HERE v 

has the same e'ffect as putting 9 blanks in the quotes, as we did 
above. Try itj, you'll like it. 

By combining the TAB with the FOR loop you can program some nice 
visual effects. For example: 

NEW 

20£ FOR ti -■■ 1 TO £4 
FGINT ■ , A3tN>"X" 
520 HE) ' N 

There are 24 (not 40) horizontal printing lines. That, by the 
way, is why thfe upper limit in the loop in the program above is 
24. TAB cannot be used to move backwards (to the left) on a 
line. Only forward moves are carried out. To print on a 
particular line, you can vertical tab (VTAB) to that line. The 
top line is lijie 1, and the bottom line is line 24. VTAB, 
unlike TAB, is not used within a PRINT statement. 

You can tab horizontally with HTAB if you don't want to use a 
PRINT statement. HTAB works like TAB except that it is not used 
within a PRINT statement. Also, HTAB can cause printing to 
begin either to the left or to the right of the current printing 
position. The leftmost character on a' line is in position 1, 
while the rightmost character is in position 40. On the next 
page is a shorj: program that demonstrates the use of HTAB and 
VTAB: 
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. 






■ ■ 




. -- i 


- 


i .--- . 


r-22 


hta:- 




VTAE i 


-' 


: [NT "AP 




NE/ 


- 


WEX7 




. a#£ 



TQ 24 



Before you RUN this program, try (it ain't easy!) to figure out 
what it will do. It's; both surprising and pretty. 

TAB works for immediate execution mode, but you can only use 
VTAB and HTAB in programs. While TAB, HTAB and VTAB act 
somewhat like the co-ordinates in PLOT, there are some 
differences. The 40 cblumns for the TAB instruction are 
numbered from 1 to 40, as they would be on a typewriter, while 
the first co-ordinate pf a PLOT instruction can run from to 
39, which is more convenient for programming graphics. Since 
characters are taller than the "bricks" we build graphics with, 
there is room for only! 24 lines of printing on the screen. 
Therefore VTAB's limitis are 1 and 24. A zero or a number that 
is too large or too smkll for TAB, VTAB or HTAB will give you an 

■Ii_L.l,. ; QUANTITY ERROR 



The largest value for VTAB is 24, but the largest value for TAB 
or HTAB is 255. Both ^AE and HTAB will tab past the length of 
the screen line and "w^ap around" to the next line. To see this 
in action, type 



\ . 

■ -OR .H * 1 Tfl 

- - - 



': 






Then try replacing lines 310 and 320 with 



r 



and adding 



What happens to the program when you replace HTAB with VTAB? 
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CHAPTER 4 

LOTS OF GRAPHICS 



74 Talking to a program on the RUN: INPUT and a bouncing ball 

78 Off the walls: a program with lots of bounce 

79 Making sounds: PEEK(-16336) 
81 Noise for the bouncing ball 

81 For higher notes 

82 Random numbers : RND and INT 

84 Simulating a pair of dice 

85 Subroutines: drawing horses using GOSUB and RETURN 
87 Traces: TRACE, NOTRACE and END 
89 A better horse-drawing subroutine 
91 High-resolution graphics: HGR, HCOLOR= and HPLOT 
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TALKING TO A PROGRAM ON THE RUN 

Here is a program that makes a dot of color move across the 
screen, bouncing off the right and left sides. 



. 


REM CK 


DOSE 1ALL COLOR 


. 


BALL = <? 




: 


RE> SE 


T GRAPHICS MODE 


460 


OF 




43* 


REM ST 


ARTING POSITION 


5-2.C 


XOLD = 2 


I 


520 


rem m 


L /E THE EALu BACK AND FORTH 


540 


E - 


■ 


5Crj£ 


NE 


A > POSITION 


580 


KNOW = X 


3LC * XMOVE 


" 


REM IS 


3AL_ ON THE SCREEN 


h20 


IF (XNQ 


ri ;• = 0TAND fXNOW . 40; 


640 


REM CH 


\teGE XMOVE DIRECT I Or. 


660 


XMOVE = 


- i * XF 


■ 


GOTO 58 


I 


700 


REM H< 


DT THE NEW BALL 


720 


COLORE 


JAtL 


740 


PLOT m 


3W, 20 


760 


REM ER 


=*SE OLD BA^:_ 


730 


COLORE 


rt 


am 


PLOT XQ 


_G, 20 


B20 


REM 5 A 


/E NEW BALL 


B40 


XOLD = X 


MQ'W 


S40 


REM MO 


je AGAIN 




SOTO 58 


J 



fe 

e 






You should always give some thought to the naming of variables. 
It may seem tha't XNEW would be a more convenient name than XNOW 
until you remenjber that NEW has a special meaning in Applesoft 
and is a reserved word. The reason that the variable XMOVE was 
called "XMOVE" will be evident if you change its value. Try 
XMOVE = 2 for example. If you set XMOVE too high, the ball will 
appear to jump iwildly across the screen, with no trace between 
positions. 

This kind of program is the basis for many typical TV games. It 
is worthwhile to spend some time playing with the program, 
changing this and that, just to see what can be done with it. 
It would be a g!ood Idea to SAVE this program so you won't have 
to retype the wjhole thing if you make a fatal change. 
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9 
3 



When you LIST this program it doesn't all fit on the screen at 
once, and the program lines scroll upward too quickly to be read 
easily. One way to see all the program lines is to LIST the 
program in portions. For example, you could type 

I rot &.&&, ,-,■-- 

and only the lines with numbers greater than 400 and less than 
680 would be printed. Then you could LIST the rest of the 
program. You can also use 



to interrupt the program listing, 
then quickly typing 



Try LISTing the program and 



before the program lines scroll up beyond the top of the screen. 

To start the listing again, type 5EB Q again. BE3 S 
can also be used to stop the listing. However, will 

abort the listing so Chat it cannot be continued from where it 
left off. 

You are now in a position to understand the bouncing ball 
program, but you might have friends who aren't. Suppose you 
wanted a friend to be able to choose the color of the ball. You 
could explain how to change line 420, but you'd also have to 
explain the possible error messages, and what to do if ...well, 
It would take a bit of explaining. It would be better to let 
your friend interact with the program. To do this, you can use 
an INPUT statement. Change line 420 to read 



When the program executes this statement, a question mark (?) 
will appear on the screen, followed by the blinking cursor. The 
Apple will then wait uhtil someone types a number and presses 
The number ityped will become the value of BALL and 
the program will resume execution. It might be a good idea to 
have the computer tell your friend what is expected. You could 
put in PRINT statements such as 

1QDE 

CT A COLOR POi E BOUNCI! 

■ . . 



. 


-l r TEXT 






. 


3EL 


■ 


PRINT *TVPE A 


■ '. 


~7ER 


■ . 


PRINT "THEN P 
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420 INPUT 
(1-15)-- ";EA 



You may also incorporate a message into the INPUT statement: 

*JHAT COLOR WOULD YOU LIKE THE BALL TO BE 



ALL 



Notice that in an INPUT statement the message must be in quotes 
and that there must be a semicolon between the message and the 
variable name. When the INPUT statement contains a message, no 
question mark is added after it. If you want a question mark to 
appear, you must include it in the INPUT message. 

Your friends csn use the backspace and retype keys to correct 
mistakes in typing, but if they make a mistake and then press 

ItiaMMfl , they will get an error message. If the character 
entered is not la number, 



?REENT£F 



will appear on the screen. If too great or small a number is 
entered, the program will either let the ball move to the right 
side of the screen and then stop, or the message 

? ILLEGAL QUANTITY ERROR IN 720 

will appear on Ithe screen, and the program will stop. For the 
most part, the tiser will not know how to restart the 
computer — and shouldn't have to. Therefore you should make the 
program check that all numbers typed by the user are correct. 
These lines wilil do it: 

424 REM IS it ALL BETWEEN i AND If? 

428 IF (BALL. > 0) AND (EALL < 16 t THEM GOTO 460 

432 PRINT "THAT WASN'T BETWEEN 1 AND 15. i[ 

436 GOTO 420 

Are you beginning to see why we advised you to leave so much 
room between lijie numbers? 

It is good programming practice to make a program as foolproof 
as possible. You have advanced to the point where you are 
writing error messages for others to read. It may be all right 
for a programmer like you to read jargon such as "? SYNTAX 
ERROR", but it Is most definitely not all right to force an 



innocent user 



deal with such nonsense. 
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Each time you use an INPUT statement, your program must check 
that what the user types is within certain limits, so that the 
program won't "blow up" or fail in any way. Dealing with the 
untutored user (and you must assume that users are not 
programmers) is an art in itself. Use of clear English 
sentences and careful checking of what the user types are always 
required. 

By the way, you can INPUT several values with one INPUT 
statement. The statement 



3000 INPUT X, Y, Z 






would display a question mark as usual, and then wait for three 
numbers to be typed in. The first number would be stored in the 
variable named X, the second number in the variable named Y, and 
the third in the variable named Z. The three numbers must be 
separated by (212123 's or commas, and the last number must be 
followed by a i;i*u);h'i i 

SAVE your best version of the bouncing ball program, just in 
case. Then, if you have not done so already, try to add 
vertical motion to it. Use the new variables Yl, Y2 and YMOVE. 
A solution is given on the next page, but try to work this out 
yourself before you look. 

When you have this program running the way you want it to, SAVE 
it on your diskette or on your tape cassette. We will use it 
again later on. 
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OFF THE WALLS 



Here is one Way to make the ball bounce off all four walls, 

statements in' black are the ones that have been added to or 

changed from the program which bounced the ball between two 
walls. 



The 



280 
300 
320 
340 
360 
380 

424 
428 
432 
436 

460 

48£ 
50G 
510 

.- 

545 
550 
562 

rS£ 
600 

*40 

i 

684 
686 
688 
690 
692 
694 
699 



REM SET TEXT MODE 

TEXT 

PRINT "TO SELECT A COLOR FOR THE BOUNCING BALL, 

PRINT "TYPE A NUMBER FROM 1 TO 15" 

PRINT "AFTER THE QUESTION MARK, " 

PRINT "THEN PRESS THE KEY LABELLED 'RETURN'. " 

.^Er CHOOSE BALL CDLOF 

IJNPUT ['WHAT COLOR WOULD v OU LIKE ? >! ; . 

REM IS BALL COLOR 1-15? 

IF (BALL > 0) AND (BALL < 16) THEN GOTO 460 

PRINT "THAT WASN'T BETWEEN 1 AND 15. ** 

GOTO 420 

PEi- 3D£ 

START WS PO- 
" -- It 
YOLD - 38 

. - . FORTH 



E 



REM MOVE BALL UP AND DOWN 
YMOVE = 1 

i PCS 

. '.; - ;:oll ■■ XMQ 
RET-' -U_ QN THE SCREEN" 

if (xro " *« $) m : 

REM 

■ ; E « - 









THEN gq 






REM NEW Y POSITION 
YNOW = YOLD + YMOVE 

REM IS BALL ON THE SCREEN? 

IF (YNOW > = 0) AND <YNOW < 40) 

REM MOVE BALL UP 
YMOVE = - 1 * YMOVE 

GOTO 686 



THEN GOTO 720 
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E 

E 
E 
E 
E 
E 
E 
E 
E 
E 
E 
t 






1 



~M REM NEw BALL 

ITGi_PJR« BAU 
- Dl XKC . f 

- -■.-..: tf-|e 



850 YOLD = YNOW 






890 GOTO 580 



PQSITIOIN 

OLD BAi_i_ P i : 



L PDS.I1 EQN 



As you will see when you RUN this program, the result is a bit 
repetitive. You can alter the pattern of bouncing by changing 
the starting values of XOLD and YOLD (lines 500 and 510), but 
here is a change you might like better: 



. 



- 



To see what this does, play with the paddles. 

One more suggestion. Why not have another INPUT, giving a value 
to a variable called BACKGROUND? Fill the screen with the color 
BACKGROUND once, at the beginning of your program (right after 
GR). Then, to erase the old ball position, use 



or even 

i . . • • : 
SAVE your favorite version of this program. 



MAKING SOUNDS 



Clicks, ticks, tocks, and various buzzes are easily generated. 
You can make sounds on your Apple if you tap it, scratch your 
fingers across it or drop it, but the sounds covered in this 
manual are produced by programming it. So go to a quiet place, 
and try working through this section. 
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To construct any sound-producing program on the Apple, you will 
need this magic formula: 

150 SOUND = PEEK (-16336) 

There is no easy explanation for this formula. The number, 
-16336, is related to the "memory address" of the Apple's 
loudspeaker, and was built into the electronics of the computer. 
You are just gjoing to have to look this number up when you need 
it. 

PEEK returns the numerical code stored at a certain location in 
the computer. At most locations PEEK only returns a numerical 
value, but at |some locations, such as -16336, it can cause 
something to happen. In this case, it causes the speaker to 
make a click. Every time the program executes this statement, 
the Apple will produce a miniscule "click." RUN the program, 
and listen to your computer closely. 

Now add this line: 

160 GOTO 150 

and RUN the program. No problem hearing this! 

To make your program beep for a limited period of time, add 
statements such as 

140 FOR BEEP = 1 TO 100 

160 NEXT B^EP 

Try it. 

A tone is generated by a rapid sequence of clicks. Any program 
that uses PEEK(-16336) repeatedly will generate some sort of 
noise. Since f 16336 is such a bother to type, we will insert 
another statement that will allow us to substitute a symbol 
which is easier to type. Enter the statement 






100 5 = -16336 

To produce a nice, resonant click, change line 150 to 



150 SOUND = FEEK(S) - PEEK(S) * FEEKfB) - PEEK(S) -. 
PEEK (S) - PEEK (3) 

Different numbers of PEEKs in the statement will produce 
different quality clicks. Try RUNning some variations. For 
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more buzzy tones, put one of your variations into a loop. In 
general, the faster the loop, the higher the pitch. 

Now, to use these sounds, LOAD the bouncing-ball program called 
Off the Walls back into the computer. Try adding a "bounce" 
sound each time the ball rebounds from a wall. 

One possible solution is given on the next page, but try to work 
it out for yourself, first. (Hint: a bounce occurs whenever 
either MOVE or YMOVE changes value.) 

NOISE FOR THE BOUNCING BALL 

Here is one way to make the bouncing audible. Add these lines 
to the Off the Walls program: 



24 g re- £■£ i t ; - ^DDPES^ C Si -~*-lr 






fe?5 NEXT B 

v?: E*EM BOUNCE NOISE 






- Pi-Pi. 



kLfs < b 






Now try your own sounds. Why not make a different sound off 
each wall? 

FOR HIGHER NOTES, 

MULTIPLE STATEMENTS ON ONE LINE 

To get still higher tones, another feature of Applesoft BASIC 
can be introduced. Itl is possible to put more than one 
statement on the same line. Try this one-line program: 

The colon (:) can be used to separate statements in any program 
where you wish to have more than one statement on a line. 
However, only the first statement on the line has a statement 
number, so you can only branch to the first statement with a 
GOTO. 

Now add 
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: Ofi PAUSE = I TG 2500 FvLX 7 " PAUSE 



6 i 
6 i 

6. ! 



The advantages of multiple statements with a common line-number 
are these: 

1. The statements are executed faster. (This is an advantage 
only if you need more speed.) 

2. More of your program can fit on the screen. J* ! 

3. It can save some typing. 

4. You can group statements together that collectively perform K^ i 
one function, such as the pause in line 40 above. 

5. It requires less memory. (This is an advantage only if you 

are running out of space, and the computer gives you an ?OUT fj j 

OF MEMORY or a PROGRAM TOO LARGE message while you are 

entering a program.) Cg | 

There are also some disadvantages: ^^ I 

1. The program is harder to read. fc^ J 

2. It is harder to modify or correct the program. 

3. You can branch only to the first statement in a line. ^ i 

4. It is very discouraging to type in a long, multiple 

statement only to have it return a ? SYNTAX ERROR when the 1 

program is RUN, making it necessary to retype the whole K ! 

statement. 

RANDOM NOTES g \ 

Try this short program on your Apple. 

i&# PR INT FfhiD' 1 ) 

Ufl GOTO *00 f» 

RUM 

The RND in line 100 stands for RaNDom. The RND function returns 

RaNDom numbers. Stop the program with ^ 

The numbers generated by this program were RaNDom decimal 

fractions between zero and one. Ej 

Change line 100 to 

0J3 PRINT :•;■- fe 



and RUN the program. 
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Again stop the prograri with (3E8 G • Hmmm, interesting. The 
random numbers are still all between zero and one. Write down 
the last number that was generated so you'll remember it. 

Now change line 100 again, this time to 

100 PRINT RNG.<£) 



and RUN it. Stop the 'program and compare what you wrote down 
with what is now on the screen. RND(0) returns the last RaNDom 
number that was generated. 

Random decimal fractions between one and zero can be a little 
clumsy. Often integers (numbers like 3,6 and 10) are easier to 
use. To get random integers from to 9 we have to add a few 
more lines to the program. Type 

HE,- 
9i R£M ASSIGNS mD rttJttfiER TO > 

\-W X m RNDCi ) 

1 10 REM MULTIPLIES X BY 10 

120 X = X * 10 

130 REM CHOPS OFF THE FRACTION 

150 PRINT X 

Line 140 introduces thfe INT function. The statement INT(X) 
gives the largest integer that is less than or equal to the 
value of X. For instance, if the value of X is 3.6754, then 
INT(X) is equal to 3. j The parentheses following INT can contain 
any arithmetic expression or numeric variable. 

Now RUN the program. t)oes it work the way you expected? To 
change the program so that it generates numbers from one to ten 
instead of from zero tp nine just add one to the value of X by 
adding this line to your program: 



Try it. 

The program may seem a little complicated at first. To see step 
by step what happens, Vou can add lots of PRINT statements. 
Modify your program to look like this one. 
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?0 REN ASSIGNS KHZ NUMBER TC ;.. 

10% * = RNOKl) : PRINT ,! X~EN0<1 : ; ; 

I 05 PRRR 

J 10 REf'l f-iuLTIPLIES X BY 10 

j20 X = i * l£ : PRINT H X»}t*U'S X 

)25 PRtNT 

1.30 REG '.rGJPG OFF THE FPACTIG-. 

140 X = XNT ; :x^ : PRINT "X-lNTI )0 "* > 

145 PPINT 

15? FEii ADDS :. TG «"HE VALUE OF 3 

160 X = X f ] : PRINT w X??X+l n 

l~0 PRINT X 

175 PRINT 

I3G FOR PAUSE = 1 TG 20(20 NEXT PAUSE 

190 GG7G I'M 

RUN this program, and see what it does. 

If you want to get fancy, you can condense this program to just 
one line: 



100 PRINT INT C 10 * RRD( 1 ) 
Do you know how line 100 works? 



GG TG 100 



SIMULATING A PAIR OF DICE 

You can use what you've learned about random numbers to write a 
program that pretends to be a pair of dice. 



NEW 

110 
120 
130 



PRINT fWHITgCKE". 

PRINT INT (6 * RND(l)) * i 

PRINT VRBODlCK"! 

PRINT | NT it * RNuiD) + 1 



This program generates random integers from one to six for each 
die. To rerol^L the dice, reRUN the program. Can you write a 
program that uses these "dice" to play a game? Try it. 

Try writing, a one-line program that generates random numbers 
from 1 through 50. From through 25. Make up your own 
numbers. Remember to add (1) to the random number if don't you 
want to generate zeros. 

Here's a colorful way to use RaNDom integers. 
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E 
fe 
fe 
fe 
E 
E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

fc 



NEW 

2m 

210 
220 
230 
240 
250 
2d0 
270 
2 50 
290 



REM 
C DL 
REM 



REM 
FLO 
REM 
GOT 



CHOOSE 
OR- INT 

CHOOSE 
. N ' ! 4 & 
INT (40 * 

PLOT THE 
T X, Y 

DO it AGAI 
220 



A RANDOM COLOR 
( idl) * RND( i ) ) 
A RANDOM POINT 

* rno an 

* RNDU ) ) 

RANDOM POINT 



Try using RND in other programs. Can you write a program that 
draws lines in RaNDom cplors across the screen? 



SUBROUTINES 

Imagine that there is a 
Looks like a blue horse 
is a program that draws such a piece: 



game for which you need a piece that 
with orange feet and a white face. Here 



N t If* 

i0£0 

1^30 
1040 
1050 
1060 
t07g 

1080 



REM PROGRAM TiJ DRAW i BLUE HORSE t l"H UNITE FACE 

AND GRANGE FEl 

GR 

COLOR- 7 : REfc l. i l --Hi Hl ; j;; 



16 
ORA GE 



HLIK 15, 17 A" 
CQLOR= c R£ 

-LOT 15: 17 
PLOT 17, 17 
COLOR = 15 : R$T^ WHITE 



There is nothing wrong 
horse with orange feet 
needed to draw another 



with this program; it does draw a blue 
and a white face. Now, suppose you 
lorse somewhere else on the screen. You 
could rewrite this program with new values for X and Y, but that 
is a bother. There should be some way of using the same program 
to put a figure anywhere on the screen without having to rewrite 
it each time. 



The key to doing this begins with the observation that you can 
move a point which is at coordinates (A,B) to the right by 
adding to the value of the first coordinate, A in this case. 
For example, the point (4,17) moves 10 columns to the right if 
you add 10 to the first coordinate, making the point (14,17). 
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Likewise, a point 
coordinate (or 
show you that 
coordinate mo 



moves left if you subtract from the first 
add a negative value). A simple experiment will 
adding to, and subtracting from, the second 
points down and up, respectively. 



With these fac 
"center" the 
"almost" any 
edge of the sc 
might give you 
line number) 



horse 



po 



cs in mind, you can rewrite your program to 

at almost any point (X,Y) on the screen. Why 
int? Because, if you choose a center point at an 
teen, the horse will go off the screen, and this 
an ? ILLEGAL QUANTITY ERROR IN 1(330 (or some other 
message. Here is an improved program. 



.000 

.020 
.030 
.040 
.050 
.060 
.070 
.080 



REM P 

COLOR*" 

PLOT 



CGLGR=i 9 
PLC 7" ;<[ V 
PLOT X + 
CGLCR = i 1 
PLOT 



A HORSE ANYWHERE 
" : REM LIGHT SLUS 

( + 2 AT Y 

: REH ORAMOE 

+ 1 



Ti-fC C, ^.- -.-£_] 



WHITE 



- I i Y- 1 



You notice tha 
part of the 
here would 



the GR has been left out. We want to use this 
program to put several horses on the screen. A GR 
the screen before each new horse was drawn. 



cle* r 

This program can't be run just as it is. First you must set 
GRaphics mode, and choose X and Y. A good first try at using 
the horse program might be: 



?■?; 



GR 



50 V = 3 S3 



[RSF HORSE 



If you try to RUN this, you do get a horse at the desired 
location, but tjhe program ends there. We want to put two horses 
on the screen. What if you could write 

60 

70 REM SECOND HORSE CENTER 
80 X ■ 33 

70 V = 2 

.00 

Do the portion of the program at line 
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again and then end. 



fe 

fe 

fc 

E 

E 

E 

E 

fc 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 

E 



Wouldn't that be nice and easy? You know that the computer 
can't read those strange instructions at lines 60 and 100. It 
can, however, read 



GOSiJD I0££ 

in Applesoft. A program such as the one starting at line 
is called a subroutine . GOSUB 1000 tells the computer to GO 
to the SUBroutine beginning at line 1000 and start executing at 
that statement. It also tells the computer to come back to the 
line that follows the GOSUB statement when it is finished with 
the subroutine. The computer knows the subroutine is finished 
when it encounters a RETURN statement. To make your 
horse-drawing partial-program into a complete subroutine, add 
the line 



NZ-R0 RETURN 

Now you can write that "what if you only could" program: 



=w; - r i-ST HORSE CENTER 



50 



ov G0SU3 IM0 

" REr-1 SECOND HORSE CENTER 

m X - 33 

9% ■ = 2 

i&C OQSUS 100'i 

Now RUN the program. You get an error message: 

■'RETURN WITHOUT GOSUB ERROR IN 1^90 

but otherwise the program seems to RUN fine. In effect, you 
have added a new statement to Applesoft: a horse-drawing 
statement. Now you can use the statement 

OOSUE 1000 

to draw one of these special horses at whatever X,Y location you 
have chosen. 



TRACES 



The portion of the program from line 1000 to 1090 is called a 
subroutine or subprogram . The portion of the program from 
line 20 to line 100 is called the main program . 
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To see the 
a special feat 
you why the Ap 
program was ex 



program's flow, or path of execution, you can invoke 
are called TRACE. This special feature can show 
jle gave an error message when the horse-drawing 
*cuted. Add this line to the main program. 



and, for a moment, delete line 20. 
and RUN the prpgram. 



Put the Apple into TEXT mode 



The numbers yoji see on the screen are the line-numbers of each 
statement as i: is executed. You can see how the program begins 
at line 10, continues through the main program until the 
subroutine cal., then executes the subroutine, goes back to the 
main program, executes the subroutine again, and, not finding 
any smaller line numbers, goes to line 1000 and executes the 
subroutine again. This is where the problem occurs. Do you 
understand the error message now? 

To remedy the problem, add this new line to the program: 

. i Ekz 

When the progrkm gets to line 110, it will do just what the line 
says: end. RUN the program once more. No more error message. 
As you have jus|t seen, TRACE is very handy when you are having 
problems with I program. If you want to TRACE only part of a 
program, you c^n use the NOTRACE statement. Add this line: 



and the progran)i will be TRACEd only up to the execution of line 
65. 



TRACE can also 

i rase 



be issued in the immediate mode. Simply type 



and your program will be TRACEd. 

Once you have issued the TRACE command, whether in immediate 
mode or as a statement in your program, your program will be 
TRACEd every time you RUN it, from then on. To stop TRACE, you 
must issue a NC TRACE command, either in a line of your program, 
or in immediate mode. 
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A BETTER HORSE-DRAWING SUBROUTINE 

Subroutines should be written so that problems from possible 
errors do not arise when the program is RUN. One problem with 
our horse-drawing subroutine is that some values of X and Y will 
cause the horse to go off the edge of the screen. This can be 
prevented by a set of statements such as: 



1012 


IF 


< i THE^ X = I 


I #14 


I F X 


:- -z" ;>£>•: ,-. = 


1316 


I F V 


< 1 THEN ':'■ = 1 


:vM£ 


^ r- 


? 3S THEN V - 



(Why should the maximum Y value be 38, while X must be limited 
to 37?) 

If there is any attempt to locate a horse off the screen, the 
horse will be moved tq the nearest edge. There are other 
possible strategies, sjuch as giving an error message and 
stopping the program, j However, our choice has the advantage 
that it doesn't stop tihe program, and you can see that something 
is happening. 

Sometimes you want to jbe able to change the values in a 
subroutine for different program GOSUBs. For example, a second 
player may want to place a piece, and that should be a horse of 
a different color. One way to do this would be to type the 
whole subroutine again), with different colors. However, let's 
try using variables rajther than numbers. Instead of line 1(310 
saying COLOR = 7, it cjould say 

1®W CQLQR= BQDV 
Similarly, you could write 

COLOR* FEE' 7 

L070 CULGR= FaCE 

Then the main program tould go like this: 



30 REM 1ST Pi..- f BR 

■ : -■ ■ - 

50 FEET = 9 

a0 FACE = IS 

■ 3 Ren ist player ' 

&& X = 15 

■'. ■■■ - 30 



S HORSE COL OF 
Rfefl I ISHT BLUE 
ffETl QRANGE 

WHITE 

S HORSE CENTER 
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and so on (be sure to follow with an END statement, before you 
try to RUN it). That's a lot of statements each time you want a 
horse, but it is still fewer than if you had to type out the 
entire horse program each time. For additional programming 
ease, a rather subtle trick is to have a subroutine that assigns 
the colors foi each player's horse — and have each of those 
subroutines cajll the horse-drawing subroutine, in turn. 



BLUE HGR5E WITH ORANGE FEET AND WHITE !T ^Ci 
REM LIGHT BLUE 
REM GRANGE 
REM WHITE 



2500 REM DRAWS ORANGE HORSE WITH PINK "FEET AND GREL: 

2510 BODY = 9 : REM ORANGE 

2520 FEET =,11 REM PIN> 

2530 FACE = 12 : REM GREEN 

254(3 GQSU2 1000 

2550 RETURN 

Now all you need, to put a blue horse with white a face and 



2000 


REM Df 


AWS 


2010 


BODY" = 




2020 


FEET = 


9 : 


2030 


FACE = 


1 5 : 


2040 


G0SU2 


1000 


20 50 


RETURh 





orange feet at 



(10,11), is 



30 REM 1ST PLAYER'S HORSE 

40 X = 10 

50 r = 11 

60 GQSUE 2«J00 

To put an orange horse at (19,2) all you need is 

70 REM 2ND PLAYER'S HORSE 
S0 X = IF 
a* y = n 

100 GQSUE 2i500 

Both the horsefdrawing subroutines on the previous page, 
beginning with lines 200(3 and 2500, call another subroutine that 
begins at linei 1000. Things get to be quite efficient at this 
stage. Once you have written a good subroutine that checks for 
errors and uses variables that you can set in the calling 
program (which may be the main program or another subroutine), 
then you can pyramid other subroutines upon it. This makes main 
programs much uasier to write. Using the three subroutines, it 
is very easy to put up an attractive display of horses. 

But first, another handy routine: 






90 



! 
& ' 

■Pj 

6 
& 
& 

E j 
fci 

I 

fej 
fe 

Ej 
B] 

l\ 

&i 
E: 

E: 
6j 

6: 



3000 R£M CHOOSES RANDQH X,v 

31-10 % = INT (RN0< i) * 

3^20 * = if— iSND^ 

3-330 "3 TURN 



And, now for the main 






program. 



10 REM ££T GRAPHICS i^UDE 

jj£ REH CHOOSE A f^NDuN. POINT 

-0 3G3U5 30£3 

30 303^/3 2000 

70 RON C'HQOSE ANOTHER RANDOM POINT 

80 OGSUS 3000 

-■0 p^w pyr ^jfj OR£NQ£ H0R3E fHERE 
£0 G033B 25£0 



pro!g 



This is how a main 
programmer: mostly REIi^s 
relatively short sub 
and complete in itselfj. 
sample program does Its 



ram should look if you are a good 
and GOSUBs. The work should be done in 
each of which is easy to write, 
Feel free to use TRACE to see how this 
stuff. 



routines 



HIGH-RESOLUTION GRAPHICS 

We call the kind of graphics you have been using so far, 
low-resolution graphics. In this section you will learn to 
use another kind of graphics called high-resolution graphics. 
This new kind of graphics lets you draw with much more detail 
than you could with ths 40 by 40 low-resolution grid. The new 
high-resolution graphi :s screen is 280 by 160 plotting points. 
The horizontal coordinates start with at the left of the 
screen and end with 27? at the right. Likewise the vertical 
coordinates go from it the top of the screen to 159 at the 
bottom. 



High-resolution graphi 
high-resolution graphi 
sponding low-resolutic 
addition of an H (for 
low-resolution graphic 



:s are not difficult to understand. Often 
commands are the same as the corre- 
graphics commands except for the 
High-resolution) . A thorough knowledge of 
is will be helpful to you in this section. 
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Type 



high- 



to get into 

the screen to 

As with low- 

you to use vei 

(192 is the maximum) 

screen at all. 

times until it 



-resolution graphics mode. This command clears 
black, leaving four lines at the bottom for text, 
resolution graphics, high-resolution graphics allow 
tical coordinates that would be in the text area 
but these points are not shown on the 
If the cursor is not visible, press i^ti::m a few 
appears near the bottom of the screen. 




rid 



High 



The HGR comma 
Applesoft 
cassette and 
24K of memory, 
to use high- 
Applesoft, see 



High-resoluti 
make some sacr 
colors availabl 
high-resolution 
colors are 

blackl 

1 green 

2 violet 

3 white 1 



These colors 
positions on 
color number 
coordinate of 
coordinate is 
horizontal 
TVs work. 









is not available with cassette or diskette 
i-resolution graphics are not available in 
diskette Applesoft unless your Apple has at least 
If you have at least 24K of memory and you wish 

olution graphics with cassette or diskette 

Appendix D for more information. 



graphics are truly wonderful, but you do have to 
ifice in order to use them. There are fewer 
e in this new kind of graphics mode. The 
colors go from (black) to 7 (white). The 



4 black2 

5 orange 

6 blue 

7 white2 



Will vary from TV to TV and according to their 
t|he screen. A high-resolution dot plotted with 
for example, will be blue if the horizontal 
the dot is even, green if the horizontal 
odd, and white only if both the even and the odd 
coordinates are plotted. This is due to the way home 



If you have an 

second column appear identical to those in the first column. 



older Apple (prior to S/N 6000) colors in the 



fe 
fe 

& 
& 

t 
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3 



The only instruction [for PLOTting in high-resolution graphics is 
HPLOT. To try this o:t, once you have issued the HGR command, 
type 



HPLOT IjO; IOC 

The last line will pliit a white, high-resolution dot at point 
X = 130, Y = 100. 




Drawing lines is even 
is in low-resolution 
on the screen TO ano 
edge of the screen, tyi 



lasier in high-resolution graphics than it 
graphics. You simply HPLOT from one point 
point. To draw a line along the top 



tlvir 



If you want to draw a line from the corner at point 279, to 
the next corner of the screen all you have to do is type 



and a line appears alotig the right edge of the screen. When you 
use this last statement, the new line takes its starting point 



and its color from the 
have issued a new HCOLC 



point previously plotted (even if you 
R command since that point was plotted) . 

You can "chain" these commands and HPLOT several lines in one 

statement if you wish. 



O 



$zm 



Applesoft on diskette o 
feature. If you have 
must use HPLOT sta 
order to draw lines. 



itenents 



r cassette cannot use this "chaining" 
Applesoft on diskette or cassette, you 
specifying at most, two points in 
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Clear the screjen with HGR, and try this on your APPLE: 



».* 



be 



There should 
isn't a continuous 
check that your 
there or isn't 
parts of the s 
TVs. 



I5V TC 0» 159 10 0,0 



a line around the edge of the screen. If there 

line around the edge of the screen, first 
typing was correct. If the line still isn't 
continuous, change HCOLOR and try again. Some 
zreen only show up in certain colors on certain 




Not only is drawing lines on your Apple easy, but diagonal lines 

are just as easy to draw with high-resolution graphics. To draw 

a line from the top left corner of the screen to the bottom 
right corner j|ust type 



tf.fli 



£ 



i 59 



Practice drawing high-resolution lines of varying length and 
color. 

Here is a proglram that mak.es your Apple into a high-resolution 
sketching screen. 



NL..V- 




200 


HQtj: 


". 1 


HC Oi-GF 


230 


:- = FC, 


--V-: 


V - POL 


240 


IF v ; 


^ 


HPLQT 


2*0 


GOTO : 



I-t- THE H 



Line 240 is in:luded because the PDL function can return 
game-controller values up to 255, and the Y coordinate would be 
off the screen if its value were larger than 159. RUN this 
program 
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fc i 

I 

E l 

e ■ 
1 

i 

Ej 

Ej 

Ej 

ej 

Ej 
Ej 
Ej 
Ej 

i 
Ej 

E: 

Ej 

E 



This program works, b^it it would be improved if it were easier 
to draw a solid line. Those gaps between plotted points are not 
always desirable. You can improve the program by typing the 
following lines: 



22£ 

240 

260 
1000 

t$vi- 

1020 



GGSUS KpOiQ 
HPLGT X, \ 
GGSU3 L&0Q; 
HP LOT TG X, 
GOTO 240 
X = FDl t 0? 1 
V = PuLi 1 ) 
RETURN 



. 913 
1. 6 






LIST the program and dheck it carefully to make sure you typed 
everything correctly. Here's what the program does. 
High-resolution graphics and HCOLOR are set, and then the 
program goes to the subroutine beginning at line 1000. The 
subroutine determines the value of the X and Y coordinates. The 
game controls each return a maximum value of 255. Because 
high-resolution graphics uses horizontal coordinates from 
through 279, the value's returned by PDL(0) are divided by .913 
to expand their range to the full screen width. Similarly, the 
values returned by FDL(l) are divided by 1.6 to compress their 
range down to the range of high-resolution vertical coordinates: 
to 159. As with low^resolution graphics, the coordinate 
actually plotted is the nearest integer value less than or equal 
to the given value. Line 1020 RETURNs to the main program, and 
then line 230 plots the point X,Y. Next the program goes back 
to the subroutine, gives X and Y new values and RETURNS to line 
250 in the main program where a very short line is drawn from 
the old point X,Y to the new X,Y. The GOTO in line 260 repeats 
all of the program except the HGR and HCOLOR instructions, 
getting new values for X and Y from the position of the game 
controls, and then PLOTting the new X,Y position. Use 
to stop the program. 

There is a reason for c rawing lines instead of plotting each 
point separately. It takes a certain amount of time to plot a 
point, and when the Apdle plots points one at a time it can't 
always keep up with the game controls. That's why there were 
spaces between dots when you moved the knobs on the game 
controls quickly in the first sketching program. Drawing a 
short line to each new position specified by the game control 
knobs remedies this: in drawing a line from one point to 
another, all the pointsj in between are plotted automatically and 
much more quickly than if they had been plotted one at a time. 
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Now SAVE the rirogram, and then RUN it. 

Here's a program that draws pretty "moire" patterns on your 
screen. 



NEW 

9a ho«£ 

100 VIAE 



ZE 



RE? MOVE CURSOR TG BOTTOM LINE 
120 HGR ' ff.EN SET HI -RES GRAPHICS MODE 
140 A - RNjJ 

iS0 N « IN 



RND 



579- P.£* PI ■:«-■: AN :; A" FOP CENTER 
■ 5 C REN PIC:-: A " E ! '- ROF CENTER 

REW Pt'Ctf A STEP SI 



-r ■ AL '. 



2££ HT4E it- PRINT ''STEPPING B ' ■' '- ; N; 

£20 FOR X * TG 27S STEP N: REM STEP THROUGH A VA- 
LUES 

24$ FOR S !■ 5 TC i: REM 2 LINES. FROM X ANT X + 

2d0 HCOLQP^ 7 * S REN FI8ST LiNE BLACK, NEXT WHIT 
F 

2SC REX DfltAfe LINE THROUGH "CENTER v TO OPPOSITE BID 

E 

3<2>£ HPLOT K -r c, TO A, £ TO 2"'9 - X - Si 159 

32^ NEXT S X 

34<5 FOR V f C TG i 5E STEP N: RE' STEF THROUGH £ V- 

LUES 

360. FOR S 4= C TG 1: REN 2 LINES.- FRG.1 E AND X t- 1 

3SG HGGLQR+ ~ * S: REN FIRST LINE SLACK, NEXT WHIT 



400 



REN 
IDE 



DRA^ 



-INE THROUGH 



;ENTEfi ' 



OPPCSi ro p. 



42£ HPLOT £79, ¥ * S TG A. E TO 0, 1 59 - Y - S 

44N NEXT S Y 

4*<£ FOR PAUSE = 1 TO I5£G: NEU V PAUSE: REN DE._A ■ 

4SG GCTG 11Z0 

This is a rather long program; type it carefully and LIST it in 
portions (LIS" 0,325) for instance) to check, your typing. When 
you are sure it is correct, RUN the program. 




If you have Applesoft on diskette or cassette, you will have to 
type the plotting chains in lines 300 and 420 as separate HPLOT 
statements. Here's an example of how to do this: 

300 HPU3T 'X - Sr J5 TO A.. E 

310 HPLOT TO 279 - X - S, 159 

42?> HPLOT 279, V * S TO A, E 
43G HPLOT TC (J, 15? - Y - S 
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As you saw in lines 320 and 440, one instruction can provide the 



NEXT for more than on 
the NEXT variables in 
loops. 



3 FOR statment. Be careful that you list 
the right order, though, to avoid crossed 






To go back to program ning, stop the pattern by typing 









and then 






Can you think of ways to change the program? After SAVEing this 
version on your diskette or cassette recorder try making the 
value of HCOLOR change randomly. Try drawing first orange then 
blue lines, or only bi.ue lines. 

There is much more to high-resolution graphics than is presented 
here. When you feel confident using the high-resolution 
graphics commands presented in this section, refer to chapters 
eight and nine of the Applesoft BASIC Programming Reference 
Manual for more information on high-resolution graphics 
capabilities. 






97 



fe 
fe 
fe 
fe 
fe 

fe: 
fe 
fe 
fe 
fe 
fe 
fe 



98 



fe 
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CHAPTER 5 

STRINGS AND ARRAYS 



100 Stringing along:! LEK, LEFT$, RIGHTS, HID$ and CLEAR 

105 Concatenation gat your tongue?: putting strings together 

105 More string functions: VAL and STR$ 

108 Introducing arrays : DIM 

110 Array error messages 

111 Conclusion 



STRING ING ALONG 



Would you 1: 
have played 
manipulate 
single char 
characters 
humans also 
which con 
names 
variable 
Here are 



tain 
String 



ke to see your name spelled backwards? So far we 
with graphics and numbers, but computers can also 
etters and symbols. Your computer can deal with a 
cter, or it can handle a whole string of 
t a time. This will seem fairly natural, since we 
usually deal with characters in bunches. Variables 

character strings, like numeric variables, have 
variable names follow the same rules as numeric 
except that they end with a dollar sign ($). 

examples of string variable names: 



A* 

SENTENCE 

The variable 
be used in 



A is different from the variable A$, and both can 
t|he same program. 



If you wish 
"NAME -dollar 
type 



the string variable called NAME$ (pronounced 

") to contain the letters "HARRY S. TRUMAN" you can 



UArti 



NAftEf = l; HARRY £;. TRUMAN 

Notice that the characters that you put into a string variable 
must be enclosed in quotes. The statement 



$ 



will print the contents of the variable NAME$: in this case, the 
name of the 33rd President of the United States. Thus, when you 
have a strinj of characters that you need often, you can store 
the string ii a variable with a short name. 

There are several more Applesoft instructions that manipulate 
strings. Suppose you want to know the length of a string (how 
many characters it contains). You can type 

or you can tVpe the equivalent statement, 

PRINT LENiNAr^. 

and the Appl4 will PRINT the LENgth of the string, in this case 
15. Notice that spaces count as characters. 
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The number of characters 
If you try to use mo 
just get the 7SYNTAX 
string with charac 
the Applesoft BASIC 
information on null 



On some occasions you 
To do this you can ut 
RIGHT $ and MID$. 

If, for instance, you 
NAME$ you can type 



in a string may range from to 255. 
than 255 characters in a string you will 
15RR0R or 7STRING TOO LONG ERROR message. A 
t<:rs is called a null string. Refer to 
Programming Reference Manual for more 
strings. 



may want to PRINT only a part of NAME$. 
lize three very handy functions: LEFT$, 



want to PRINT the first five letters in 



PRINT LEFTS (NAME*, p) 

and 

HARRY 

should appear on the screen. If you type 

PRINT RIGHTS NAME* 5 5 

RUM AN 



will appear. For each 
variables, you must assign 
program. Each time you 
first set to the value 
contain the null string 
functions LEN and LEFT|$ 



program you write that uses string 
the string value within the 
RUN a program, all numeric variables are 
and all string variables are set to 
Here's a short program that uses the 



NEW 

90 NAME* = "HARRY fi. TRUMAN" 
100 FOR N = i TO LEN (NAME*) 
1 1 PR I NT LEFT* < N^ME*. N ) 
120 NEXT M 



RUN this program. The 
command except that it 
string. Now write ano 
LEFT$. What happens 



RIGHT $ command is just like the LEFT$ 
uses the rightmost characters in the 
:her program substituting RIGHT $ for 
when you RUN it? 



If you want to use characters starting from the middle of the 
string instead of the beginning or end, the MID$ function is 
what you need. 
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Type 

PRINT MI Dl* ( NAME* , 7 ) 
Your computer replies with 

S. TRUMAN 

since S is 'the seventh character in the string. Now try this 
program. 

NEW 

190 NAME*} = "HARRY E. TRUMAN" 
200 FOR N = 1 TO LENCNAMEfc) 
2 1 PR I m n I D* ( NAME*, U > 

222? NEXT 1 N 

Do you get what you expect when the program is RUN? 

Suppose you I want to PRINT just the "Y S. T" from the string 
called NAMEp. To do this you add another argument to the MID$ 
function. 

PR I NT Htmi NAMES, 5.. 6 ) 

The first number (5) specifies the string character space at 
which the Aiple is to begin PRINTing. The second number (6) 
tells it how many character spaces to PRINT. Thus the 
instruction is interpreted by the Apple as "find the fifth 
character space in NAME$, and PRINT six character spaces 
beginning at: the fifth and moving to the right." Change line 
210 of the previous program as follows, and RUN it. 

210 FP I HI MI 0$ ( NAMES , N, 6 > 

Don't go any further in this book until you've thoroughly tested 
the LEFT$, ^IGHT$ and MID$ functions. Or else. 



Consider thi 

NEW 

20(3 A* «■ 

21;2 PRINT 

220 PRINT 

230 PRINT 
POSIT 

240 INFU 

250 IF P 

2h0 PRINT 

270 PRINT 



s program. 

^C DEFGF I JKLMN0P3RSTU \'W X V Z " 

"TYPE » NUMBER, rrtuh \ THROUGH ,; ;LENiA$;;" 
:, AND I WTLL TELL YGU WHICH LET ~Efi HAS THAT 
ION IN THE ALPHABET. ' 



280 PRINT 
29.5 PRINT 



LEMA2). OP. 



HID*<A*, P, 1 •}; " 



:S i-ErTES NUMBER 



' IN THE ALPHABET 



: PRINT 

"TYPE A 



-ETTER, AMD 



WIL 



'ELL YOU" 
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I 
1 

3 

a 
a 

3 

a 
a 

a 

3 
I 



3m INPUT "WHERE II IS IN THE ALPHABET. 1! ;X* 

310 FOR N = 1 TO LE'N(A*> 

320 IF MI&»<fr**W. I) ~ X$ THEN GOTO 370 

330 NEXT N 

340 PRINT 

350 PRINT "-THAT IS NOT A LETTER OF THE ALPHABET. " 

360 GOTO 290 

370 PRINT 

380 PRINT X*-, 

3 9 IS PRINT 

400 GOTO 210 



PR INI 



IS LETTER NUMBER ",N;" IN THE ALPHABET. " 



This program illustrates! some common programming practices. 
Notice how it finds the position of a character in a string. 
This method of using a loop to scan through a string, one 
position at a tine, is vi»ry common. Also notice the function of 
the blank spaces in the 7RINT statements. What would happen to 
the output without these blank spaces? Finally, observe that 
the program limits are a!. ways set by LEN(A$), rather than the 
actual number of characters in the alphabet. This allows the 
program to work even if you specify a different "alphabet" in 
line 200. Try it and sec 

You can substitute one storing for another with a replacement 
statement such as 



= A* 






This statement copies the contents of A$ into X$. However, you 
cannot use partial string notation on the left side of a 
replacement statement. Pjor example, the statement 






is illegal, but the statement 

X5 = MID5C A$, 24 v 3) 



is OK. Only a variable c|an be on the left side of a replacement 
statement. 

Oh yes — still want to see| your name spelled backwards? The 
program on the next page ^ill do just that. 
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NEw 
I'M 

110 

120 
130 

140 
150 
160 
170 
1S0 



REM PRC 

INPUT 
BAG KNAR 
REN RES 

FOR T 

ft* ■ R* 

NEXT T 
PRINT 
PRINT 
GOTO HJ 



GRAN TO SPELL YOUR NAME BACKWARDS 

TYPE YOUR NAME AND I WILL SHOW IT Tu YQU SPSLLFI 
DS U ;N3 

fERSE ORDER GF LETTERS 
L£N(N*> TO 1 STEP -l 
+ <ttI0«<Nf< T* ti ) 

PRINT "YOUR Hm& SPELLED BACKWARDS IS ,l ;R$ 
PRINT 





program 



RUN this 
program execut 
is a something 
your name is 
and thus set 
Joe is there w 
backwards too. 
would type his 
R$ to the old 
YLLASEOJ. What 
variables to z 
each GOTO. 



175 CLEAR 



trying several different names. After the 
5S itself a few times you will notice that there 
wrong. Line 140 is the key to the problem. If 
Sjally, for instance, you would type it when asked 
i to SALLY and R$ to YLLAS. Perhaps your friend 
th you and wants to see his name spelled 
The next time the program asks for a name he 
name, setting N$ to JOE. Line 140 would then set 
St$ plus N$ spelled backwards, in other words, 

is needed is a command that resets string 
=ro, so R$ can be refilled with characters after 



Fortunately thbre is such a command in Applesoft. It is the 
CLEAR command. CLEAR resets all variables of every size, shape 
and color to 0. Add this line to your program. 



program 



again, 
can also be used in immediate execution. Type 



Now RUN the 

The CLEAR commjand 

N = 254 
PRINT N 

Now type 

CLEAR 

and then 

PRINT N 

again. Did your Apple give as the value of N? 
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CONCATENATION GOT YOUR TONGUE? 



II 

r 
i 
i 
i 



It is possible to add a second string onto the end of an 
existing string using the plus (+) sign. This process is called 
concatenation . Try the following on your Apple. 

C5 * "GOOD HORN 1 NO" 
D$ = G* + " " * :! 3ILL 
PRINT D* 

Your Apple will respond with 

GQGD MORNING BILL 

Concatenation is especially useful if you wish to take a string 
apart and then put it back; together with slight modifications. 
For instance, if you wante^ to create a new string that was the 
same as D$ except that the spaces between words would be 
substituted with dashes, you could type 

E$ = RIGHT*<D$, 4) + "-" + LEFTS (BS, 4) + "-" + MIDtfCOS.- 
PRINT E$ 

and 

BILL-GQOD-MQRNJNG 

would appear on your screed * 

Here's a program that uses concatenation. 

NEW 

im INPUT "-GIVE ME ABOUT HALF OF A SENTENCE. i! ; HALF* 

U0 INPUT "NOW GIVE ME THE SECOND HALF OF THE SENTENCE 

"■; T HER HALF ft 
120 WHOLE* = HALF* * OJHERHALF* 
130 PRINT 
i40 PRINT WHOLES 
150 PRINT : PRINT : PsIINT : GOTO 100 

And that's how you can do concatenation. 

MORE STRING FUNCTIONS 

Strings can be made up of almost any kind of character, 
including numbers. However^ like items in a PRINT statement, 
the characters between the <niote marks in a string cannot be 
interpreted arithmetically even if they are numbers. To see 
what happens when you try, type 
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C* - "i23 ii 

PRINT C* + 7 

Your Apple wilf confusedly print 

•■■'TYPE MISMATCH ERROR 

and not be abl^ to deal with the last statement. We need the 
help of the 

VAL 

(short for VALiie) function to alleviate this problem. 

The VAL function returns the VALue of the contents of a string 
as opposed to its actual contents. Type 

PRINT C$ 

and then type 

PRINT VALtC* 

Both commands apparently get the same result; however, 
appearances car be deceiving. You already know that if you type 



PRINT C* + 5 
your Apple wil]( respond with 

•"TYPE MISMATCH ERROR 
Try typing 

print y&Liea 

and 



appears on the 









screen. Notice that the string variable name 
which is the arjgument of the VAL function must be enclosed in 
parentheses. 

What if you want to put the value of C$ minus 21 into an 
ordinary (non-string) variable? Simple. Just type 



E 

£ 

£ 

fc 

fe 

6: 
6 
fe 

E 
fe 

E 
E 

E 

E 

E 

E 

E; 

E: 

fc 

E: 
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Now type 

PRINT Q 

and see what you get. Are the contents of Q as you expect? You 
can even use VAL to add the numerical value of two different 
strings. To try this, creiate a new string 



K* = "12" 
and then type 



P = VAL(C*) +■ VAL(K*> 
PRINT F 

Try VAL with different str 
end with letters. 






ings, including strings that begin or 



Sometimes it is necessary (to change a number into a string. The 
STR$ function, which works; much like the VAL function in 
reverse, can be used to majte this change. Suppose you want to 
change the numeric variable P to a string variable. Typing 

P$ = STR*(P) 
PRINT P* 

will show you how STR$ works. Here is a program that uses STR$ 
and VAL. 

300 INPUT "TYPE A NUMBER FROM 1 THROUGH 999999999. 

310 N = VAL(N$> 

320 IF N < i OR H > 999999999 THEN GOTO 300 

330 m - 3TR*<N> 

340 FOR T = LEN(N*> TO 1 STEP -1 

350 P$ - P$ + MID*<N$, T, 1) 

360 f-4EXT T 

370 PRINT : PRINT "OR l£INAL tr , N* 

360 PRINT : PRINT "REVERSED" , P* 

390 P = VALCP*) 

^00 PRINT : PRINT "GRI3IMAL ->- REVERSED = H ; N -> F 

41£ CLEAR 

420 PRINT : PRINT : GOTO 300 

Do you understand how the program works? Why are there commas 
in lines 370 and 380? Try deleting line 330 to see what its 
effect is. The first four lines of this program demonstrate the 
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first steps t 
See what input 
ways to catch 
stop. 



oward making a truly "bomb proof" input routine. 
s can still stop this program, and then devise 
those inputs before they can cause the program to 
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INTRODUCTION ARRAYS 



In this section on arrays we use examples from mathematics, but 
they are from recreational mathematics and require nothing 
beyond elementary arithmetic. 

Arrays enable Vou to select any element in a table of numbers, 
and the prograjnming power they give you more than compensates 
for the bit of! thinking and experimenting you must do to become 
familiar with jthem. 



An array is a 
called the arr 
example. The 
simple variabl 



Lable of numbers. The name of this table, 
ay name , is any legal variable name: A, for 



array name A is distinct and separate from the 
5 A. 



To create an array, you must first tell the computer the maximum 
number of elements you want the array to accommodate. To do 
this you use a DIM statement (DIM stands for DIMension) . The 
elements in an array are numbered from 0, so to DIMension an 
array called Ai that will have a maximum of 16 elements, type 

DIH ACL5) 

The DIM statement above has given us 16 new variables. They 
behave exactly: like the variables you have come to know and 
love. They ar£: 

A(0> 
A( I ) 
A ( 2 ) 

and so on, dow^i to 

A( IS) 

Although you nuy find them awkward to type, they can be used 
just as any other variable is used. The statement 

A< 9) = 45 + A( 12) 

is perfectly correct. The number in parentheses is called a 
subscript , and the notation A(12) is read "A-sub-twelve." The 
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subscript can be an arithmetic expression or it can be 
represented by a variable. 

Type the following program. It illustrates the use of variables 
in the subscript and prints out a display of the contents of 
each array element. 



1 R £ M D I M E N 310 ^ I 

110 uin DA'-i 5(6) 

I ~?0 REM F I !_'— . THE f; 

130 FOR NU^ = TC 

1 40 DAYS i Mim) - NU 

130 NEaT MUfl 

160 P.EM PRINT THE 

17$ FOR I = TO c 

18jS PRINT u DAYS(*i 

1 :: NEXT I 



If an array is used in 
Applesoft reserves spa 
10). However, it is 
all arrays. 



TG HOLD 7 NUKE EPS 



RRAY 



. r; .'■■. t;,.Eht:NT- 



a program before it has been DIMensioned, 
e for 11 elements (subscripts through 
g<jiod programming practice to DIMension 



Suppose you want to write a program that generates the numbers 
: rambled order. To accomplish this you 



from one to eight in sc 
need to manipulate tab] 
thing for which arrays 
page accomplishes this 



es of data. This is just the kind of 
are excellent. The program on the next 



km 
210 
220 

■ ■ 
■ ■ ■ 

■ 

; 
. 



- ; . 

REN 



WAS MILK 



IF NOT- THY AGAIN 



IF MILK - WINE 
REft INTERCHAN 



REn DIMENSION THE ARRA' 1 

can glass<S; 

REM FILl THE KfiRAY 
FGR I - X TG S 
GLASS m - I 
NEXT : 

REr 6C8AJSBt.£ trHE ARRA 7 AND ;HGGSE EACH MEN! 

FDR WiftE = 1 T3-B 
REtf CHOOSE SO lE OTHER ELEMENT 

f-iiL'A = int i Rao -; i :• *"8> - 



DIFFERENT FRGK WINE" 



THEN GOTO 280 
jfeE GLASS (WINE AND GuASS CW-ILKJ 
jLftSSfWlflE):-QLASS(W;I^E") = GLASS.;- ;L. 
3SMILK - TE\ 
I EWE 

con ■ 

'•'•■ 

- 1 

EXT ; 



109 



Do you understand how this program works? It first fills an 
array with nvmbers and then scrambles the contents of the array. 
Notice that you don't have to start filling the array at zero. 
Here's a description of what some of the more elusive program 
lines do. Lines 230 through 250 fill the array and assign each 
array element a number corresponding to its array number 
(GLASS (1) * 1, etc.). Line 270 sets the new variable WINE to 
numbers 1 through 8. Line 280 sets variable MILK to random 
integers fron 1 to 8. Then line 300 makes sure that the value 
of WINE is not equal to the value of MILK at any given time. 
The contents of variables GLASS (WINE) and GLASS (MILK) are 
switched in line 310. Finally the array is printed with lines 
330 through 3;50. 

The switchingl that occurs in line 310 can be thought of like 
this. Lets sjay we have two glasses — one is a wine glass (WINE), 
and the others is a milk glass (MILK). Oh no, there was a 
mistake. The milk is in the wine glass and the wine is in the 
milk glass. jLuckily we have an extra glass (TEMP). We can pour 
the milk into the extra glass, then pour the wine into the wine 
glass, and, fJLnally, pour the milk into the milk glass. Now 
both drinks h£ve been switched to their proper glasses. 

ARRAY ERROR MESSAGES 

Here are a few error messages you might generate while 
programming with arrays. 

?REDIM'D ARRAY 

This error message occurs when an array is dimensioned more than 
once in the same program. Often this error occurs because the 
default dimension has been used, and a dimension statement has 
been added to the program afterwards. 

?BAD SUBSCRIPf ERROR 

If an attempt is made to use an array element that is outside 
the dimension, of the array, this error message will occur. For 
instance, if 1 has been dimensioned to 25 with the statement DIM 
A(25), referring to the element A(52) or any other element whose 
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subscript is less than 
SUBSCRIPT ERROR. 

? ILLEGAL QUANTITY ERRC^t 
You will get this mess 
an array subscript 



or greater than 25 will give the ?BAD 



age if you try to use a negative number as 



used here are all one 
arrays that have two o 



These are some of the irays that you can use arrays. The arrays 



iimensional arrays. You can also use 
more dimensions. See the Applesoft 
BASIC Programming Reference Manual for more a more information 
on arrays. 



CONCLUSI 



°N 



This book has presented the core of Applesoft BASIC. If you now 
go through this book aiain, writing your own programs with the 
statements that have been presented here, you will solidify your 
knowledge considerably! The Apple has many more abilities, and 
once you have mastered i those presented here, there are whole new 
worlds for you to explore. 
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128 
128 
128 
129 
129 
130 



131 

131 
132 
133 
133 
134 
136 
137 

140 



147 
147 
148 



Appendix C: Editing Features 
Left and righi arrow keys 
Pure cursor moves 
Deleting program lines 
Clearing the Screen 
Summary of edit features 



114 Appendix A: Summiry of Commands 



126 Appendix B: Reserved Words in Applesoft 



mrcare 



discussion 



Appendix D: Fi 

Cass* 
Introduction 
General 

An important riote 
Part 1: The Applesoft 
Part 2: 
Part 3: Ca 
Part 4: Diff 



Diskette 



assette 



Applesoft versus 
tte or Diskette Applesoft 



II firmware card 
Applesoft 
tape Applesoft 

es between diskette or cassette 
Applesoft and firmware Applesoft 
Part 5: Memory locations used by DOS and by 
Applesoft BASIC 



143 Appendix E: Error 



Old 



Appendix F: The 
Using the old 
Recovering frok 



Monitor ROM 
aonitor ROM 
accidental RESETs 



Messages 
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APPENDIX A: SUMMARY OF COMMANDS 



(This appendix) contains both Applesoft and DOS commands.) 

The following is a summary of the commands that can be used in 

the Applesoft BASIC programming language. For more information 

on these commands, see the Applesoft BASIC Programming Reference 
Manual* 



Arrow Keys — » 

The keys marked 
edit Applesoft 
to the right; 
screen is ent 
key moves the 
erased from 
regardless of 



the 



with right- and left-pointing arrows are used to 
programs. The right-arrow key moves the cursor 
as it does, each character it crosses on the 

as though you had typed it. The left-arrow 
cursor to the left; as it moves, one character is 

program line which you are currently typing, 
what the cursor is moving over. 






CALL -151 

Causes the asterisk prompt to appear indicating that the Apple 
is now responding to its native language called machine 
language. If you are not an advanced programmer, you will 
probably not njeed to use this command. 



CATALOG 

Displays on th 
in the 
of sectors 
the file name. 



specified 



screen a list of all the files on the diskette 

or default drive. The file type and the number 

occupied by the file, are indicated to the left of 
The file types are: 



The file is an Integer BASIC program. 

The file Is an Applesoft BASIC program. 

The file consists of Text: it was created 

by a WRITjE command. 

The file is a bit-for-bit image of a portion 

of Apple'js memory. 



I 
A 
T 



The CATALOG command is a DOS (Disk Operating System) command, 
not an Applesoft command. 



CLEAR 

Sets all variables to zero and all strings to null. 



& 



114 



£ 









1 
r 

i 
i 
i 
i 
i 
■ 

■ 

i 
■ 
i 
■ 
i 
i 
i 
i 
i 
i 

I! 
I! 
I 



COLOR = 12 

Sets the color for plotting in low-resolution graphics mode. In 

the example, color is set to green. Color is set to zero by GR. 

Color names and their associated numbers are: 



black 

1 magenta 

2 dark blue 

3 purple 



dark green 
f;rey 

medium blue 
light blue 



CONT 



8 brown 

9 orange 

10 grey 

11 pink 



12 green 

13 yellow 

14 aqua 

15 white 



If program execution has been halted by STOP, END or CTRL C, the 
CONT command causes execution to resume at the next 
instruction (like GOSUB) — not the next line number. 
Nothing is cleared. CONT cannot be used if you have 

a) modified, added or deleted a program line, or 

b) gotten an error message since stopping execution. 



CTRL C 

Can be used to interrupt a RUNning program or a LISTing. It can 
also be used to interrupt an INPUT if it is the first character 
entered. The INPUT is not interrupted until the RETURN key is 
pressed. 



CTRL X 



Tells the APPLE to ignore the line currently being typed, 
without deleting any previous line of the same line number. A 
backslash (\) is displayed at the end of the line to be ignored. 



DEL 23,56 

Removes the specified ^ange of lines from the program. In the 
example, lines 23 through 56 will be DELeted from the program. 
To DELete a single lin4, say line 350, use the form DEL 350,350 
or simply type the line number and then press the RETURN key. 



DIM NAME $(50) 



When a DIM statement is| executed, it sets aside space for the 
specified array with subscripts ranging from through the given 
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subscript. Iri the example, NAME$(50) will be allotted 50 + 1 or 
51 strings of any length. If an array element is used in a 
program before it is DIMensioned, a maximum subscript of 10 is 
allotted for each dimension in the element's subscript. Array 
elements are iet to zero when RUN or CLEAR is executed. 



END 

Causes a 
user. No 



progrjam to cease execution, and returns control to the 
message is printed. 



ESC I or ESC J or ESC K or ESC M 

The Escape key, may be used in conjunction with the letter keys I 
or J or K or M to move the cursor without affecting the 
characters moved over by the cursor. To move the cursor, 
first press and then release the ESC key to enter edit mode. 

Then press the appropriate letter key once for each move in the 
desired direction. The REPT key can be used to speed the moves 
by pressing the appropriate letter key and then pressing the 
REPT key whilej holding down the letter key. 



command mo"v 



cursor one space 



ESC I 
ESC J 
ESC K 
ESC M 



FLASH 



up 

left 
right 
down 



Sets the videoi mode to "flashing", so the output from the 
computer is alternately shown on the TV screen in white 
characters on black and then reversed to black characters on a 
white background. Use NORMAL to return to a non-flashing 
display of white letters on a black background. 



FOR W = 1 TO 2(3 
FOR Q = 2 TO - 
FOR Z = 5 TO 4 



. . . NEXT W 
3 STEP -2 ... NEXT Q 
STEP 3 ... NEXT Z 



Allows you to Vrite a "loop" to perform any instructions between 
the FOR command (the top of the loop) and the NEXT command (the 
bottom of the loop) a specified number of times. In the first 
example, the variable W counts how many times to do the 
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B 
E 
E 

fc 
E 

E 
E 
E 
& 
E 
E 
E 
E 
E 

e 

E 

E 
E, 

E 
E 

1 



instructions; the instructions inside the loop will be executed 
for W equal to 1, 2, 3, ...20, then the loop ends (with W = 21) 
and the instruction after NEXT W is executed. The second 
example illustrates how to indicate that the STEP size as you 
count is to be different from 1. Checking takes place at the 
end of the loop, so in the third example, the instructions 
inside the loop are executed once. 



GOSUB 250 



Causes the program to branch to the indicated line (250 in the 
example). When a RETURN statement is executed, the program 
branches to the statement immediately following the most 
recently executed GOSUB .; 



GOTO 25(3 

Causes the program to brjanch to the indicated line (250 in the 
example) . 



GR 



Sets low-resolution GRaphics mode (40 by 40) for the TV screen, 
leaving four lines for t«xt at the bottom. The screen is 
cleared to black, the cursor is moved into the text window, and 
COLOR is set to (black). 



licoLon. - k 



Sets high-resolution graphics color to the color specified by 
HCOLOR. Color names and their associated values are: 



blackl 

1 green 

2 violet 

3 whitel 



4 black2 

5 orange 

6 blue 

7 white2 



On older Apples, prior to S/N 6000, the colors in the second 
column will look the same as those in the first column. 



HGP 

Only available in the firitiware version of Applesoft. Sets 
high-resolution graphics mode (280 by 160) for the screen, 
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leaving four lines for text at the bottom. The screen is 
cleared to black, and page 1 of memory is displayed. Neither 
HCOLOR nor teit screen memory is affected when HGR is executed. 
The cursor is not moved into the text window. 



HGR 2 



Sets full-screen high-resolution graphics mode (280 by 192). 
The screen is cleared to black and page 2 of memory is 
displayed. Text screen memory is not affected. 



HLIN 10, 



Used to draw horizontal lines in low-resolution graphics mode, 
using the color most recently specified by COLOR. The origin (x 
- and y = (3) for the system is the top leftmost dot of the 
screen. In tie example, the line is drawn from x - 10 to x = 20 
at y = 30. Another way to say this: the line is drawn from the 
dot (10,30) thorough the dot (20,30). 



HOME 



Moves the cursor to the upper left screen position within the 
text window, and clears all text in the window. 



HPLOT 10,20 

HPLOT 30,40 TO 50,60 

HPLOT TO 70, m 



Plots dots and lines in high-resolution graphics mode using the 
most recently specified value of HCOLOR. The origin is the top 
leftmost screen dot (x = 0, y = 0). The first example plots a 
high-resolution dot at x ■ 10, y = 20. The second example plots 
a high-resolution line from the dot at x = 30, y = 40 to the dot 
at x = 50, y A 60. The third example plots a line from the last 



dot plotted to 



last dot plotted , not necessarily the most recent HCOLOR. 



HTAB 23 

Moves the cur 
through 40) on 
positioned in 



the dot at x 



70, y 



using the color of the 



r either left or right to the specified column (1 
the screen. In the example, the cursor will be 
column 23. 
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IF AGE < 18 THEN A = 

IF ANS$ = "YES" THEN GOT( 

IF N < MAX THEN GOTO 2! 



= 1: C = 2 



If the expression following IF evaluates as true (i.e. 
non-zero), then the instructions) following THEN in the same 
line will be executed. Otherwise, any instructions following 
THEN are ignored, and fexecution passes to the instruction in the 
next numbered line of the program. String expressions are 
evaluated by alphabetic ranking. 



INPUT A 

INPUT "TYPE AGE THEN A COMMA THEN NAME. 



B, C$ 



In the first example, INPUT prints a question mark and waits for 
the user to type a number, which will be assigned to the numeric 
variable A. In the second example, INPUT prints the optional 
string exactly as showJi, then waits for the user to type a 
number (which will be Assigned to the variable B) then a comma, 
then string input (whi<fh will be assigned to the string variable 
C$). Multiple entries! to INPUT may be separated by commas or 
RETURNS . 



INT (NUM) 

Returns the largest integer less than or equal to the given 
argument. In the example, if NUM is 2.389, then 2 will be 
returned; if NUM is -45.123345 then -46 will be returned. 



INVERSE 



Sets the video mode so that the computer's output prints as 
black letters on a white background. Use NORMAL to return to 
white letters on a black background. 



LEFT$ ("APPLESOFT" , 5) 



Returns the specified number of leftmost characters from the 
string. In the example^ APPLE (the 5 leftmost characters) will 
be returned. 



Left Arrow 

See "Arrow Keys". 
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LENC'AN APPLE A| DAY") 
LEN(B$) 

Returns the number of characters in a string, between and 255. 
In the first example, 14 will be returned. 



A = 23.567 

A$ = "DELICIOUS 

The variable nane to the left of = is assigned the value of the 
string or expression to the right of the ■ . 



LIST 

LIST 200,30(3^ 

LIST 200-3000 



npl 



tie 



The first exairn 
the TV screen; 
200 through 300fl 
program through 
to the end of 
by CTRL C, and 
program tempora 
Use CTRL S agaiji 



LOAL 



e causes the whole program to be displayed on 
:he second and third examples cause program lines 
to be displayed. To list from the start of the 
line 200, use LIST -200 ; to list from line 200 

program, use LIST 200- . LISTing is aborted 
:he CONT command cannot be used. To stop the 
ily at some point in the listing, use CTRL S. 
to resume the listing. 



Reads an Applesoft program from cassette tape into the 
computer's memory. No prompt is given: the user must rewind the 
tape and press "play" on the recorder before LOADing. A beep is 
sounded when information is found on the tape being LOADed. 
When LOADing is successfully completed, a second beep will sound 
and the Applesoft prompt character (] ) will return. Only RESET 
can interrupt a LOAD. 



LOAD bOU JONES 






Attempts to find a program file with the name DOW JONES on the 
diskette in the specified or default drive. If the program is 
found, it will be LOADed into the Apple's memory. LOAD erases 
any program in i:he Apple before placing the new program in 
memory. This command, when followed by a file name, is a DOS 
command. 
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MID$("AN APPLE A DAY" 
MID$(DAY$,4,9) 



4) 



Returns the specified 
fourth through the last 
returned: APPLE A DAY. 
characters beginning 
will be returned: APPLE 






subs 



string. In the first example, the 
characters of the string will be 
In the second example, the nine 
wiJth the fourth character in the string 
A D 



Deletes current program and all variables 

NEXT 

See the discussion of FpR. . .TO. . .STEP. 

NORMAL 



Sets the video mode to 
background for both inpiit 



the usual white letters on a black 
and output. 



NOTRACE 

Turns off the TRACE modfe. See TRACE 



FDL(l) 

Returns the current 
indicated game control 
are valid. 



PLOT 1.0 



value, a number from through 255, of the 
paddle. Game paddle numbers through 3 



In low-resolution graphics mode, places a dot at the specified 
location. In the example, the dot will be at x = 10, y = 20. 



The color of the dot is 



COLOR, which is (black) if not previously specified. 



determined by the most recent value of 
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PRINT 
PRINT A$; 



X 



The first example causes a line feed and RETURN to be executed 
on the screen. Items in a list to be PRINTed should be 
separated by commas if each is to be displayed in a separate tab 
field. The items should be separated by semi-colons if they are 
to be printed right next to each other, without any intervening 
space. If A$ contains "CORE" and X is 3, the second example 
will cause 

COREX = 3 

to be printed. 



REM THIS IS A REMARK 

Allows text to be inserted into a program as remarks. 

REPT 

If you hold down the repeat key, labeled REPT, while pressing 
any character key, the character will be repeated. 

RETURN 

Branches to the statement immediately following the most 
recently executed GOSUB. 



RIGHTS ( "SCRAPPLE", 5) 
RIGHT$(S$,2) 

Returns the specified number of rightmost characters from the 
string. In the first example, APPLE (the 5 rightmost 
characters) will be returned. 



Right Arrow 

See "Arrow Keys". 
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RND (5) 



Returns a random real number greater than or equal to and less 
than 1. RND(0) returns the most recently generated random 
number. Each negative argument generates a particular random 
number that is the same every time RND is used with that 
argument, and subsequent RND's with positive arguments will 
always follow a particular, repeatable sequence. Every time RND 
is used with any positive argument, a new random number from 
to 1 is generated, unless it is part of a sequence of random 
numbers initiated by a negative argument. 



RUN 5(3(3 



Clears all variables, pointers, and stacks and begins execution 
at the indicated line number (500 in the example) . If no line 
number is specified, execution begins at the lowest numbered 
line in the program. 



RUN ANNUITY 



LOADs the file called ANNUITY from the specified or default 
drive and then RUNs the program LOADed. When followed by a file 
name, RUN is a DOS command, not an Applesoft command. 



SAVE 



Stores the program currently in memory, on cassete tape. No 
prompt or signal is given. The user must press "record" and 
"play" on the recorder before SAVE is executed. SAVE does not: 
check that the proper recorder buttons are pushed; "beeps" 
signal the start and end of a recording. 



SAVE ADDRESSES 



SAVEs the file currently in memory. If no file called ADDRESSES 
is found on the diskette in the specified or default drive, a 
file is created on that diskette and the program currently in 
memory is stored under the given file name. If the diskette 
contains a file with the specified file name, and in the same 
language, the original file's contents are lost and the current 
program is SAVEd in its place. No warning is given. SAVE, when 
followed by a file name, is a DOS command. 
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STR$(12.45) 

Returns a string that represents the value of the argument. In 
the example, the string "12.45" is returned. 



TAB(23) 



Must be used in a PRINT statement; the argument must be between 
and 255 and enclosed in parentheses. For arguments 1 through 
255, if the argument is greater than the value of the current 
cursor position, then TAB moves the cursor to the specified 
printing position, counting from the left edge of the current 
cursor line. If the argument is less than the value of the 
current cursor position, then the cursor is not moved. TAB(0) 
puts the cursor into position 256. 



TEXT 

Sets the screen to the usual non-graphics text mode, with 40 
characters per line and 24 lines. Also resets the text window 
to full screeni 



TRACE 



Causes the line number of each statement to be displayed on the 
screen as it is executed. TRACE is not turned off by RUN, 
CLEAR, NEW, DEL or RESET. NOTRACE turns off TRACE. 

VAL("-o. 7£<-rk5PlA") 

Attempts to interpret a string, up to the first non-numeric 
character, as a real or an integer, and returns the value of 
that number. If no number occurs before the first non-numeric 
character, a is returned. In the example, -37000 is returned. 



VfLIK 10,20 AT M 



In low-resolution graphics mode, draws a vertical line in the 
color indicated by the most recent COLOR statement. The line is 
drawn in the column indicated by the third argument. In the 
example, the line is drawn from y = 10 to y = 20 at x = 30. 
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VTAB (15) 

Moves the cursor to the 
argument. The top line 
VTAB will move the curao 



line on the screen specified by the 
is line 1; the bottom line is line 24. 
>r up or down but not left or right. 
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APPENDIX B: RESERVED WORDS 
IN APPLESOFT 

The following list contains all of the reserved words in 
Applesoft BASIC. Although most of these words are not covered 
elsewhere in this manual, the list is handy as a guide for 
naming variables. Refer to the Applesoft BASIC Programming 
Reference Manual to find out how to use more of these commands. 



ABS 

AND 

ASC 

AT 

ATN 

CALL 

CHR$ 

CLEAR 

COLOR= 

CONT 

COS 

DATA 

DEF 

DEL 

DIM 

DRAW 

END 
EXP 

FLASH 
FN 
FOR 
FRE 



GET 
GO SUB 
GOTO 
GR 

HCOLOR= 

HGR 

HGR2 

HIMEM: 

HLIN 

HOME 

HPLOT 

HTAB 

IF 

IN# 

INPUT 

INT 

INVERSE 

LEFT$ 

LEN 

LET 

LIST 

LOAD 

LOG 

LOMEM: 

MID$ 



NEW 

NEXT 

NORMAL 

NOT 

NOTRACE 

ON 

ONERR 

OR 

PDL 

PEEK 

PLOT 

POKE 

POP 

POS 

PRINT 

PR# 

READ 

RECALL 

REM 

RESTORE 

RESUME 

RETURN 

RIGHT $ 

RND 

ROT= 

RUN 



toke ni 



Applesoft 
only one byte 
program storage 



SAVE 

SCALE- 

SCRN( 

SGN 

SHLOAD 

SIN 

SPC( 

SPEED= 

SQR 

STEP 

STOP 

STORE 

STR$ 

TAB( 

TAN 

TEXT 

THEN 

TO 

TRACE 

USR 

VAL 

VLIN 

VTAB 

WAIT 

XPLOT 
XDRAW 



cf 



zes" these reserved words: each word takes up 
program storage. All other characters in 
use up one byte of program storage each. 
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h 
E 
i 

fe 

fc 

6 

fc 

E- 



The ampersand (&) is 
only; it is not a prop 
executed as an instruc 
location $3F5. 



tended for the computer's internal use 
er Applesoft command. This symbol, when 
tion, causes an unconditional jump to 



XPLOT is a reserved wojrd that does not correspond to a current 
Applesoft command. 

Some reserved words are recognized by Applesoft only in certain 
contexts. 



reserved 
tie 



COLOR, HCOLOR, SCALE, 
parse as 
character is 
little benefit 
the included 
variable names 



SPEED, and ROT 

words only if the next non-space 
replacement sign, = . This is of 
in the case of COLOR and HCOLOR, as 
reserved word OR prevents their use in 
anyway . 



SCRN, SPC and TAB 

parse as reserved words only if the next non-space 
character is a left parenthesis, ( * 

HIMEM: must have its colon (:) to be parsed as a reserved 
word. 

LOMEM: also requires A colon (:) if it is to be parsed as 
a reserved wortj. 



ATN 



TO 



is parsed as 
between the T 
T and the N, tl 
of ATN. 



reserved word only if there is no space 
and the N. If a space occurs between the 
e reserved word AT is parsed, instead 



is parsed as a reserved word unless preceded by an 



A and there is 
space occurs be 



100 FOR A 
LISTs as 100 FOR A 



a space between the T and the 0. If a 
tween the T and the 0, the reserved word 



AT is parsed instead of TO. 



Sometimes parentheses can be used to get around reserved words: 



LOFT OR CAT TO 15 
LQF TO RC AT TO 15 



but 100 FOR A = (LOFT) OR (CAT) TO 15 
LISTs as 100 FOR A = (LDFT) OR (C AT ) TO 15 
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APPEND 



The Left and Right Arrow Keys 



The lef t-pointiing 
moves the curs 
passes over. 
last line you 
characters on 



arrow key, also called the backspace key, 
or back (left) one space, erasing the character it 
If you haven't pressed (gflfl at the end of the 
typed, the backspace key only affects the 
that line. 



Pressing the r 
retype key, 
character it 
key, then presjs 
retyped the li 



ight-pointing arrow key, also referred to as the 
the cursor move forward (right), retyping the 
ss es ove r. If you retype a line with the retype 
EJJffll , the Apple behaves as if you had 
by hand. 



makes 



pa 



You can cause 

key whifl 



the cursor to move more quickly by pressing the 
e pressing one of the arrow keys. 



Pure Cursor Moves 



The E3 i Q 
cursor without 
Imagine arrows 



Pressing (£3 
mode, pressing 
the cursor to 
corresponding 
anywhere on th 

For faster cu 
hold down the 
keys are held 
screen, it wi 
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X C: EDITING FEATURES 



€3 , O , and Q keys are used to move the 
affecting any of the characters on the screen, 
drawn on the letter keys as illustrated: 



gets you into edit mode. Once you are in edit 
one of the above-mentioned letter keys will cause 
nove one character in the direction of the 
arrow. You can use these keys to move the cursor 
screen. 

Dr motion, hold down one of these keys and then 

key. The cursor will zip along while both 
iown. If the cursor reaches the top of the 
stop. If the cursor reaches the bottom of the 



1L 



E 

& 
E 
E 
E 
E 
E 
E 

e 

E 
E 
E 
E 
E 
E 
E 
E 
E 



screen, it will stop, 
If it reaches the right 
reappear at the left e 
edge, it will reappear 
normal mode, press the 



and the lines will start to scroll upward. 

edge, the cursor will disappear and 
idge, but on the next line. At the left 

on the right, one line up. To return to 

space bar once. 



Deleting Program Lines 



An easy way to delete 
number of the line you 
you have more than one 
the DELete command. T 
200 you would type 

DEL 100,200 

All program lines from 
deleted. 

Typing 



a program line is simply to type the line 
wish to delete and press liUMIJI . If 
line to delete, you may wish to utilize 
delete, for instance, lines 100 through 



will delete the line 
when you realize you 

l:iail.:iil 



Clearing the Screen 



to 



inclusive, should then be 



yDu 
have 



are currently typing. This is useful 
made a mistake before you have pressed 



The following commands 

not what is stored in [the Apples memory 

once puts you in edit node. 



affect only what you see on the screen, 

Pressing the 133*1 key 



To clear the screen, type (3j3 followed by an "at" sign. 



The cursor will appear 
without the prompt 
press i:.3iiiu'i . 

If you are already in 
simply typing an "at" 
normal mode. 



at the top left-hand corner of the screen 
Tljie prompt character will appear when you 



udit mode you can clear the screen by 
ign (@). The Apple will return you to 
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The HOME com[nand will also clear the screen. Simply type 
HOME 



and the curs 
screen. 



jr will "home" to the top left-hand corner of the 



It is also possible to clear only portions of the screen. To 
clear from a point on the screen to the end of the screen, get 
into edit mode by pressing I358fr . Then use the pure cursor move 
features to nove the cursor to the first character you wish to 
clear. Press the Q key, and all the characters from that 
point to the end of the screen will be cleared. To clear 
characters to the end of a line, you must first be in edit mode. 
Then move th<; cursor to the first character to be cleared, and 
press B . Y.n both cases, the Apple will return to normal mode 
after the conmand is executed. 



Summary 



Enter edit mcde 
Exit edit moqe 
Move cursor 
Delete a character 
Retype a character 
Clear from the cursor 



of Edit Features 



Press 

Press space bar 

Press | H , MM , 

Press 

Press 



to the end of 



Clear from trie cursor 
to the end of the screen 

Clear the entkre screen 

Stop listing 

Resume listinb 



a line 



Press 



, then j 



Press 


| > 


then 


Press 


Q , 


then 


Press 


^^n 


and 


Press 


Iffinl 


and 



and 
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APPENDIX D: FIRMWARE APPLESOFT VERSUS 
DISKETTE OR CASSETTE APPLESOFT 



Introduction 

You do not need to read this 
using one of the following: 

1. the plug-in Applesoft 

2. Applesoft loaded from 

3. Applesoft loaded from 



i:: 



4ppendix at all unless you are 



Firmware Card 
ette tape 
diskette 



casse 



Some of the material in this appendix may seem highly technical, 
if this is your first experience with computers. Don't worry if 
you do not understand everything here, at first. Just read the 
appropriate parts, looking for! information which might help you. 
At a later time, when you know more about your computer, you may 
wish to re-read this appendix for more detailed facts. 

This appendix will use some special words which may be 
unfamiliar to you. Many of thjem describe the Apple's memory , 
which is used in a surprising number of different ways: 



1. 

2. 
3. 

4. 



5. 



6. 



To store the diskette oi the cassette version of the 

Applesoft programming language. 

To store the instructions that make up your program. 

To store your program's variables, strings, and 

intermediate and final results. 

To store various information which the Apple itself 

needs, about the system, your program, and where 

different things are stored in memory. 

To create the text and low-resolution graphics which 

normally show on your TV screen. 

To create the high-resolution graphics that can be 

shown on your TV screen, 



Each of these activities, in general, occupies a different 
portion of the Apple's memory. Information is placed in various 
memory "pigeonholes", called mjemory locations . A block of 
1024 memory locations is sometimes called _1K of memory. Each 
memory location has an identifying address , a number which 
lets the Apple find that location, and the item of information 
stored there, again. These itjems of information, which you 
rarely see in their raw, machihe-language form, are called 
bytes of information. Each byte of information occupies one 
memory location. 
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The portioiji 
activity c 
used, usua 
certain 
program, f 
used to 
program 



will 



of Apple's memory that is used by a particular 
n be described in terms of the memory locations 
ly specified as a range of memory addresses . If a 
of memory locations is being used to store your 
r instance, those same memory locations must not be 
a high-resolution graphics display, or your 
be lost. 



range 



create 



in 



In Applesoft 

expressed 

numbers in 

advanced 

in the nordal 

Hexadecimal 

and may sa 



BASIC, memory addresses and other numbers are 
the usual decimal form. The computer itself uses 
a different form called hexadecimal . To aid 
programmers, memory addresses are sometimes given both 



decimal form and in the hexadecimal form, 
numbers are usually preceded by a dollar sign ($) 
fely be ignored. 



General Discussion 

Apple Computer Inc. offers two versions of the BASIC programming 
language. Integer BASIC, described in the Apple II BASIC 
Programming Manual, is a very fast BASIC suited for many 
applications, especially in education, game playing, and 
graphics. The other version of BASIC is called "Applesoft" and 
is better suited for most business and scientific applications. 

Applesoft BASIC is available in two versions: firmware 
Applesoft and diskette or cassette Applesoft. Firmware 
Applesoft comes with Applesoft in ROM (permanent, Read-Only 
Memory) . The Applesoft ROM chips may be installed in sockets D0 
through F0 on the Apple's main printed circuit board, or they 
may be on a plug-in Applesoft II Firmware Card (Apple Part 
Number A2B0009X). Firmware Applesoft is instantly available 
when you turn your Apple on or when you type the disk command 
FP. This saves some time over loading the language from 
diskette at every use, and saves even more time over loading the 
language from cassette tape. Aside from this convenience, 
having Applesoft in ROM frees about 10K of Apple's memory for 
the use of programs. 

The main body of this manual assumes your Apple has firmware 
Applesoft installed in sockets D0 through F0 on the Apple's main 
printed circuit board. PART 1 of this appendix gives more 
details about installing and using the plug-in Applesoft II 
Firmware Card. 
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If you arc using the 
Applesoft, the 



diskette or the cassette version of 



o 



1 



IS 



j.n 



Applesoft 
Applest f t 



casset te 
elsewhere 



symbol points out places 

differs from firmware 

discusses diskette 

more details about cassett 

summarizes special instruc 

between diskette or 

Applesoft described 

of this appendix gives mo 

more advanced programmers 

memory is used by Applesoft 

An Important Note 



the 



this manual where your Applesoft 
PART 2 of this appendix 
in more detail, and PART 3 gives 
e Applesoft. PART 4 of this appendix 
tions and notes on the differences 
Applesoft and the firmware 
in this manual. Finally, PART 5 
technical information for the use of 
who need to know how the Apple's 



One of the functions of 
you for input to the compujt 
language the computer is 
Here are the prompt characters 



prompt character, besides PROMPTing 
er, is to identify at a glance which 
programmed to respond to at that time, 
you are likely to see: 



* for the Monitor program (when you type CALL -151) 

> for Apple Integer BASIC 

] for Applesoft floating-point BASIC. 



By simply looking at this 
(if you forget) which 



languag 



prompt character, you can easily tell 
~+c the computer is in. 



PART 1. THE APPLESOFT II FIRMWARE CARD 



Installation 



The Applesoft II Firmware Card simply plugs into a socket inside 
the Apple. Care must be ecercised, however, so follow these 
instructions exactly: 

1) Turn off the Apple's power switch : this is very 



important to prevent damaging the computer*. 
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2) Remove Che cover from the Apple. This is done by pulling up 
on the cover at the rear edge (the edge farthest from the 
keyboard) ur.til the two corner fasteners pop apart. Do not 
continue to lift the rear edge, but slide the cover backward 
until it conies free. 

3) Inside the Apple, across the rear of the main circuit board, 
there is a row of eight long, narrow sockets called "slots." 
The leftmost one (looking at the computer from the keyboard end) 
is slot #0; the rightmost one is slot #7. Hold the Applesoft II 
Firmware Card so that its switch is toward the back of the 
computer; insert the "fingers" portion of the card into the 
leftmost slot, slot #0. The fingers will enter the slot with 
some friction, and will then seat firmly. The Applesoft II 
Firmware Car 



d must be placed in slot 



4) The switlch 
should protrud 
Apple. 



5) 



on the back of the Applesoft II Firmware Card 
e part way through the slot on the back of the 



Replace the Apple's cover: first slide the front edge into 



place, then J>ress down on the two rear corners until they pop 
into place. 

7) Now turn on the Apple. 



Using the Applesoft II Firmware Card 

With the Appj.esoft II Firmware Card's switch in the downward 
position, th«i Apple will begin operating in Integer BASIC when 
you turn the computer on. You will see the prompt character > 
which indicates Integer BASIC. 



With the swi 
running in 
turn the 
you are in 



in the upward position, the Apple will begin 
*■ BASIC, instead of Integer BASIC, when you 
computer on. The prompt character ] tells you that 
Applesoft. 



tch 
Applesoft 



the 



When using 
automatically 
It does not 
Applesoft II 



PART 2: 



Disk Operating System (DOS), the computer will 
choose Integer BASIC or Applesoft, as required, 
matter in which position the switch is set on the 
Firmware Card. 



DISKETTE APPLESOFT 



With each Disjk II, Applesoft II BASIC is provided on the Integer 
BASIC System tester Diskette, in a program called APPLESOFT. In 
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1 

i 
1 



addition to the 2K bytes used by the Apple, and the 10K bytes 
used by Applesoft BASIC loaded from diskette, the Disk Operating 
System (DOS) occupies another 10. 5K of memory. Therefore, your 
computer must contain at least 24K bytes of memory to use the 
diskette version of Applesoft BASIC . 

To use diskette Applesoft, the disk must be booted and at least 
one disk drive must contain a diskette which has the program 
APPLESOFT on it (such Ls the System Master Diskette). Do not 
use the command RUM APPLESOFT . This command does not properly 
initialize the language: Applesoft will look as though it is 



running correctly, but 
press the RESET key or 
command 

FP 

(for Floating Point BA 

When you issue the DOS 

FP 



you will be in trouble as soon as you 
type a DOS command. Instead, use the DOS 



3IC). 
command 



your computer will attempt 
program from the diskette 
drive. If the program 
message 



LANGUAGE NOT AVAILABLE 

is given. In that cask 
that drive a diskette 
the 

FP 



to load the APPLESOFT language 

in the default (last used) disk 

APPLESOFT is not on that diskette, the 



you have two choices. You may place in 
*ith the APPLESOFT program on it, and type 



command again. Or, if! you know that a different drive 
contains a diskette with APPLESOFT on it, you may issue the FP 
command with slot and drive parameters. For example, to load 
Applesoft from the diskette in drive 2 connected to a disk 
controller card in slo: 6, you would type 

FP, S6, D2 

(see your DOS manual) 

When you LOAD or RUN a diskette program written in Applesoft, 
DOS automatically switches to the correct language. If this 
necessitates a change :o Applesoft, DOS will attempt to find the 



135 



RUN 



APPLESOFT pro£ 
the LOAD or 
drive if none 
command to 



ram on the diskette in the disk drive specified by 

command, or on the diskette in the default disk 
is specified. You may, of course, use the FP 
chinge languages yourself, as described above. 



PART 3: CASSETTE TAPE APPLESOFT 

Applesoft II KASIC is provided on cassette tape with each Apple 
II. If your system includes firmware Applesoft or a disk drive, 
you will not need to use the cassette tape version of Applesoft. 
Applesoft BAS^C loaded from cassette tape occupies approximately 
10K bytes of memory, and the Apple uses another 2K bytes for 
text screens, etc. Thus, your computer must contain at least 
16K bytes of nemory to use the cassette version of Applesoft 



BASIC . 



Getting Started With Cassette Tape Applesoft 

Use the following procedure to load Applesoft from your cassette 
tape unit: 



in 



1) Start up I 
know you are 
> displayed i 
"cursor." 

2) Place the 
your cassette 

3) Type LOAD 

4) Press the 

5) Back at th 



nteger BASIC by turning on the computer. You will 
Integer BASIC when you see the prompt character 
the TV screen, followed by the blinking square 



Applesoft cassette tape (Part Number A2T0004) in 
recorder and rewind the tape to the beginning. 



recorder's "play" lever to start the tape playing. 



a Apple keyboard, press the key marked VBliUiJ 
When you do thLs the blinking cursor will disappear. After 5 



20 seconds the 



information has started to go into the computer. After about 



1-1/2 minutes, 



an 



7) Type RUN 
display the cobyr 
prompt character 



to 



Apple will beep, to signal that the tape's 



there will be another beep and the prompt 



character > followed by a cursor will reappear. 

6) Stop the tkpe recorder and rewind the tape, 
now in the computer. 



APPLESOFT is 



d press the key marked RETURN. The screen will 
ight notice for APPLESOFT II and APPLESOFT'S 
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El 
fc 
E, 
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E 
E: 
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I 
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I 
I 
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I 
I 
I 



Typing (3E9 from the Monitor program (prompt character *) 
will transfer you to Integer BASIC; this will erase Applesoft. 

PART 4: DIFFERENCES BETWEEN DISKETTE OR 
CASSETTE APPLESOFT AND 
FIRMWARE APPLESOFT 

Applesoft on diskette or on cassette tape (Part Number A2T0004) 
does not work exactly the sdme as does the firmware version of 
Applesoft that resides in ROM on the Apple's main printed 
circuit board (sockets D0 through F0) or on a plug-in Applesoft 
II Firmware Card (Part Number A2B0009X). Most of this manual 
describes the firmware version of Applesoft. The following 
comments point out how diskette or cassette Applesoft differs 
from firmware Applesoft. 

Firmware Applesoft does not occupy any space in the Apple's 
memory, and therefore may be used with Apples of almost any size 
memory. 

Diskette Applesoft occupies approximately 10K bytes of memory, 
the Apple uses another 2K bytes for text screens and other 
system needs, and the Disk Operating System (DOS) occupies 
another 10. 5K bytes. Thus, diskette Applesoft cannot be used in 
Apples with less that 24K bytes of memory. With diskette 
Applesoft loaded into the Apple, the lowest memory location 
available to the user is 12291. See the memory map in PART 5 of 
this appendix. 

Cassette Applesoft occupies approximately 10K. bytes of memory 
and the Apple uses another 2K bytes for text screens and other 
system needs. Thus, cassette Applesoft cannot be used in Apples 
with less than 16K of memory. With cassette Applesoft loaded 
into the Apple, the lowest memory location available to the user 
is 12291. See the memory map in PART 5 of this appendix. 



o 



a 



HGR is not available in diskette or cassette Applesoft. The 
HGR command clears "page 1" of graphics memory (the portion of 
Apple's memory from location 8192 to location 16383) for 
high-resolution graphics. Since diskette or cassette Applesoft 
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partly occupied 
will erase 
command can 



this portion of memory, attempting to use HGR 
Applesoft, and your program will be lost. The HGR 
be used with firmware Applesoft. 



on.y 

The HGR2 command uses "page 2" of graphics memory (the portion 
of Apple's memory from location 16384 to location 24575). HGR2 
can be used bo ;h in the firmware and in the cassette version of 
Applesoft, but is only available if your Apple contains at least 
24K of memory. Therefore, in a system with less than 24K of 
memory, cassette Applesoft does not offer any form of 
high-resolution graphics. 




In diskette 
the HGR 2 commai|d 
graphics memory 
with less than 
DOS. Therefore 
diskette Appl 
not offer any 



Applesoft , 



fo 



The command 

POKE -16301,0 

is used in App] 
mixed graphics 
the four lines 
and not from tt 
on the text sc 
Applesoft, 
that mixed higt 



In diskette or 
the CALL 62450 
screen to black 
Applesoft's 
last HPLOTted. 




If executed 
time, these 
Applesoft. 



belo 
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and in firmware Applesoft used with DOS, 
may cause trouble when it clears "page 2" of 
(location 16384 to location 24575). On systems 
36K of memory, this will erase a large portion of 
in a system with less than 36K of memory, 
ft (and firmware Applesoft used with DOS) does 
rm of high-resolution graphics. 



esoft to convert any full-screen graphics mode to 
plus-text mode. When issued after HGR2, however, 
of text are taken from page 2 of text memory, 
e usual page 1 of text memory that is displayed 
leen. In the diskette or the cassette version of 
Applesoft itself occupies page 2 of text memory, so 
-resolution graphics-plus-text is not available. 



cassette Applesoft, use CALL 11246 (instead of 
used in firmware Applesoft) to clear the HGR2 
Use CALL 11250 (instead of firmware 
CAliL 62454) to clear the HGR2 screen to the HCOLOR 



ire you issue the HGR2 command the first 
CAIjXs may clear "page 1" of graphics memory, erasing 



The Applesoft commanc 
are using firmware Appl 



HPLOT XI, Yl TO X2, 



If you are using diskett 
such an instruction to 



HPLOT XI, Yl TO X2, 
HPLOT TO X3,Y3 
HPLOT TO X4,Y4 



Y2 



HPLOT can be used in this form if you 
esoft : 



Y2 TO X3,Y3 TO X4,Y4 



:e or cassette Applesoft, you must change 
this form: 
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PART 5: MEMORY LOCATIONS USED BY DOS 



AND BY 



I AM 



address 



Highest 
memory 

49151 ($BtiTF) 
on a 48K s) 
[ Note 1 



APPLESOFT BASIC 



stem 

] 



24*76 
($6(100) 



16:184 
($4(100) 



8.92 
($2(100) 












2348 
($0300) 



Apple's Memory 



Lowest 
memory 
0000 ($0t?00) 



RAM 
address 
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-► 


I 

10752 Disk 
($2A00) Operating 
bytes System 

(if booted) 


«- 




Applesoft strings 
start at HIMEM 
and build down 




— > 


High-resolution graphics, 

Page 2 

[ Note 4 ] 






High-resolution graphics, 

Page 1 

[ Note 3 ] * 






1 

1 

Diskette 
_ or cassette 
JH Applesoft 
Variables 1 (if used) 
start at * occupies 
LOMEM and this space 
build up , [ Note 3 ] 






Applesoft * 

program lines . 

push LOMEM up | | 




-» 


BASIC System use: 
low-resolution graphics 
and text screen, etc. 





Without DOS, 
Applesoft 
sets HIMEM here 
[ Note 1 ] 



Booting DOS 

sets HIMEM here 

[ Note 1 ] 



Diskette 

or cassette 

Applesoft 

sets LOMEM at 

12291 ($3003) 

[ Note 2 ] 



Firmware 
Applesoft 
sets LOMEM here 
[ Note 2 ] 



fe 
fe 



Note 1. HIMEM is the 
available to an Applesoft 
Applesoft, the value of 
high byte) in decimal 
hexadecimal). To see 



PRINT PEEK(115) + PEEK 



address of the highest memory location 
program. If your system is in 
HIMEM can be found (low byte first, then 
Locations 115 and 116 ($73-$74, 
the current value of HIMEM, type 



(116) * 256 



Consult the following :able for the value of HIMEM set by 
booting DOS, for systems with various amounts of memory. 
Increasing MAXFILES will move HIMEM down an additional 595 bytes 
for each file buffer added. For the locations of other 
Applesoft program pointers, consult your Applesoft II BASIC 
Programming Reference Manual, Appendix I. 



HIMEM Value Set By Booting DOS 



Highest 


RAM 


address 


Decimal 


He 


icadecimal 


16383 




p3FFF 


20479 




§4FFF 


24575 




$5FFF 


32767 




$7FFF 


36863 




S8FFF 


49151 




?BFFF 



HIMEM: set by DOS boot 
Decimal Hexadecimal 



5632 


$1600 


9728 


$2600 


13824 


$3600 


22016 


$5600 


26112 


$6600 


38400 


$9600 



System 
size 

16K 
20K 
24K 
32K 
36K 
48K 



The negative equivalent of any positive decimal address n 
is ( n - 65536 ). 



Note 2. LOMEM is the address of the lowest memory location 
available to an Applesoft program. In Applesoft, the value of 
LOMEM can be found (low byte first, then high byte) in decimal 
locations 105 and 106 [$69-$6A, hexadecimal) . To see the 
current value of LOMEM , type 

PRINT PEEK(105) + PEEK(106) * 256 

Applesoft automatically sets LOMEM just after the last line of 
the current stored program, and the first variable starts at 
LOMEM. 



Note 3. Using high- 
the contents of memory 
using firmware Applesoft 
resolution graphics Pag 



resolution graphics Page 1 (with HGR) erases 
locations 8192 through 16383. If you are 

with DOS, an attempt to use high- 
e 1 will erase part of DOS unless DOS 
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sets HIMEM td> a value greater than 16383. This means that you 
cannot use DOS and high-resolution graphics at the same time, 
unless your system contains at least 32K of memory. 

If you are using diskette or cassette Applesoft, an attempt to 
use high-resolution graphics Page 1 will always erase part of 
Applesoft* With diskette or cassette Applesoft, you may use 
high-resolution graphics Page 2, only. However, see Note 4. 



Note 4. Using high-resolution graphics Page 2 (with HGR2) 
erases the contents of memory locations 16384 through 24575. If 
you are using DOS, an attempt to use high-resolution graphics 
Page 2 may erase part of DOS unless DOS sets HIMEM to a value 
greater than 24575. This means that you cannot use DOS and Page 
2 high-resoli tion graphics at the same time, unless your system 
contains at l[east 36K of memory. 
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APPENDIX E 



: ERROR MESSAGES 



All of the error messages that can be generated in Applesoft 
BASIC are listed here along with their descriptions. See the 
Applesoft BASIC Programming Reference Manual for more 
Information on the error messages not covered in this manual. 

After an error occurs, Applesoft BASIC returns to command level 



as indicated by the 
Variable values and 



] prompt character and a blinking cursor. 

the program text remain intact, but the 
program cannot be COJNTinued and all GOSUB and FOR loop counters 
are set to 

In an immediate-execution statement, no 



When an error occurs 
line number is printed. 

Format of error messages: 

Immediate-execution Statement 
Deferred-execution Statement 



?XX ERROR 



?XX ERROR IN YY 



In both of the above 



examples, "XX" is the name of the specific 



error. "YY" is the line number of the deferred-execution 
statement where the error occurred. Errors in a 
deferred-execution statement are not detected until that 
statement is executed. 



The following are the 



? CAN'T CONTINUE ERROR 



possible error codes and their meanings. 



Attempt to continue a program when none existed, or after an 
error occurred, or aftfer a line was deleted from or added to a 
program. 



?DIVISIOH 3Y ZERO ERROR 
Dividing by zero is an e 

? FORMULA TOO COfcPLEX ERROR 

More than two statements of the form IF "XX 11 THEN were executed. 
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? ILLEGAL DIRECT ERROR 



You cannot use 
imraediate- 



an INPUT, DEF FN, GET or DATA statement as an 
ion command. 



exec at 



? ILLEGAL QUANTITY ERROR 

The parameter passed to a math or string function was out of 
range. ILLEGAL QUANTITY errors can occur due to: 

a) a negative array SUBSCRIPT (e.g., A(-l) = 0) 

b) using LOG with a negative or zero argument 

c) using SQl with a negative argument 

d) A " B with A negative and B not an integer 

e) use of MLD$, LEFT$, RIGHT$, WAIT, PEEK, POKE, TAB, SPC, 
ON... GOT D, or any of the graphics functions with an 
improper argument. 






?NEXT WITHOUT 70R ERROR 



The variable : 
variable in a 
nameless NEXT 
effect. 



a NEXT statement did not correspond to the 
FOR statement which was still in effect, or a 
iid correspond to any FOR which was still in 



?OUT OF DATA EtROR 



A READ statement 
the program had 
too much data 



?OUT OF MEMORY 









was executed but all of the DATA statements in 
already been read. The program tried to read 
r insufficient data was included in the program. 



ERROR 



Any of the following can cause this error: program too large; 
too many variables; FOR loops nested more than 113 levels deep; 
GOSUB's nested more than 24 levels deep; too complicated an 
expression; parentheses nested more than 36 levels deep; attempt 
to set LOMEM: :oo high; attempt to set LOMEM: lower than present 
value; attempt to set HIMEM: too low. 



'OVERFLOW ERROR 



The result of 
Applesoft BASEf 
is given as th 
message being 



calculation was too large to be represented in 
's number format. If an underflow occurs, zero 
result and execution continues without any error 
printed. 
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?REDIM'D ARRAY ERROR 



After an array was 
the same array was 
array has been given tt 
statement like A(I) = 2 
DIM A(100). This erroi 
discover on what prog 
just insert a dimensior 
line, RUN the program, 
original dimension sta 



dimensioned, 



enccuntered. 



? RETURN WITHOUT GOSUB ERROR 



another dimension statement for 
This error often occurs if an 
e default dimension 10 because a 
is followed later in the program by a 
message can prove useful if you wish to 
l line a certain array was dimensioned: 
statement for that array in the first 
and Applesoft will tell you where the 
tjement is. 



A RETURN statement was 
statement being executdd 



encountered without a corresponding GOSUB 



? STRING TOO LONG ERROR 

Attempt was made by use 
a string more than 255 



of the concatenation operator to create 
characters long. 



?BAD SUBSCRIPT ERROR 



An attempt was made to reference an array element which is 
outside the dimensions of the array. This error can occur if 
the wrong number of dimensions are used in an array reference; 



for instance, LET A(ll) 
DIM A(2) 



? SYNTAX ERROR 



Missing parenthesis in 
line, incorrect punctuation 



an expression, illegal character in a 
etc. 



?TYPE MISMATCH ERROR 



expected 



The left-hand side of 
variable and the right- 
a function which e; 
one or vice versa. 






Z when A has been dimensioned using 



assignment statement was a numeric 
nand side was a string, or vice versa; or 
a string argument was given a numeric 
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?UNDEF'D STATEMENT ERROR 



An attempt was 
number which 



made to GOTO, GOSUB or THEN to a statement line 
not exist. 



does 

?UNDEF'D FUNCTION E 

Reference was pade to a user-defined function which had never 
been defined. 






5 

fe 
fe 

fe 
fc 
fe 

fe', 
fe' 

fe! 
fe 

6: 
fe' 

6! 
fe! 
fe' 

fe: 

fe! 

fe! 
fe! 

fe: 
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APPENDIX F: THE OLD MONITOR ROM 



Host of this manual ass 
Autostart ROM, which ir 
BASIC when you turn on 
on your Apple, if it cl 

APPLE ] [ 



Apple contains the usua 



umes that your Apple contains the 
stantly starts your Apple running in 
the Apple's power switch. When you turn 
ears its own screen and prints 



at the top (and boots your disk, if you have one) then your 



1 Autostart ROM. 



On some older Apples, t 
screen is cleared and 



ie 6153 key must be pressed before the 
the title APPLE ] [ appears. 



However, some Apples use a Monitor ROM which works somewhat 
differently. When you i:urn on your Apple, if it displays lots 
of random characters on the screen, and these characters are not 
cleared away, then your Apple contains the "Old Monitor ROM", 
and you should read thiis section. 



Using the Old Monitor ROM 



Each time you turn on yc 
prompt character at the 
flashing cursor. This 
program, which advanced 
language". To begin ru 
Apple, you must always 



) 



ur Apple, you will see an asterisk ( * 
screen's lower left, followed by the 
indicates that you are in the Monitor 
programmers use when working in "machine 
ing in BASIC after turning on your 
through the following magic sequence: 



go 



1. Press the Bi£23f key (at the upper right corner of 
the Apple's keyboard). 

2. Hold down the JB9 key (at the middle left on the 
keyboard) and continue to hold it down while you 
type the letter Q . 

3. Press the IdaflklJI J key (at the middle right on the 
keyboard) . 



In key-symbol notation, 
looks like this: 



:he sequence to begin running in BASIC 
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Recovering from Accidental RESETS 

If your Apple contains the Autostart ROM, pressing the 

key causes no problems: you are immediately returned to the 

BASIC you were 1 just using. 



the 



W ith t he Old 

■a»M key wi 
You will see 
lower left, fdllowed 
without losing 
following: 



Monitor ROM, however, accidentally pressing the 
11 suddenly throw you into the Monitor program, 
asterisk ( * ) prompt character at the screen's 
by the flashing cursor. To return to BASIC 
any stored program, you must do one of the 



1. Without the Disk 

If you are usilng Integer BASIC or firmware Applesoft (see 
Appendix D), ypu can return to your program after an accidental 
or intentional press of the lawn key by typing 



pressed the 



This will retdrn you to the BASIC you were using when you 



key, without losing your program. 



If you are using cassette Applesoft, after pressing the iiiy^i 
key you must type 






2. With the Disk 



If you have booted DOS, no matter what version of Applesoft you 
are using, after pressing the turni p key you must type 



This will re 
you pressed 



tujrn you to DOS and the BASIC you were using when 
the ina-iag key, without losing your program. 



o 



s 






If you are us^ng diskette or cassette Applesoft, 
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1 
1 
1 
I 
I 
I 
I 
I 



will attempt to reinstate Integer BASIC as your programming 
language. This may erase Applesoft and any program in memory, 
and the uninitializedi Integer BASIC will not work correctly. 



3. With the Applesoft II BASIC Programming 
Reference Manual 

The Applesoft II BASIC Programming Reference Manual contains 
much more detailed information about Applesoft than this 
teaching manual contains. The Applesoft II BASIC Programming 
Reference Manual, howfever, was written assuming your system 
contains the Applesoft II Firmware Card (see Appendix D in the 
manual you are now reading) , and no disk. Each place where the 
Applesoft II BASIC Programming Reference Manual says to use 



diskette Applesoft users should use 



and cassette Applesoft users should use 



instead. Where the Applesoft II BASIC Programming Reference 
Manual says to use 



diskette Applesoft users can do the same, but they will then be 
in Integer BASIC, and Will have to re-boot the disk ( PR #6 ) and 
then reload Applesoft from diskette ( FP ) . Cassette Applesoft 
users will also find themselves in Integer BASIC, and will have 
to reload Applesoft from cassette tape. 
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INDEX TO THE APPLESOFT TUTORIAL 



NOTE: The page numbers in parentheses refer to the 

Applesoft II BASIC Programming Reference Manual. 



addition 23, 39-42 

address 131-132 (40, 41, 43-45) 

AND 57-59 (33, 36, 144) 

Apple Disk II Disk Drive: see di^k 

drive 
Applesoft BASIC 2 

command summary 114-125 

error messages 143-146 

loading from cassette 136 
(106-1(39) 

loading from diskette 134-136 

on cassette 2, 92, 93, 96, 131 
133, 136-142, 148-149 
(106, 108, 109) 

on diskette 2, 92, 93, 96, 13l|— 

133, 134-142, 148-149 

on firmware card 6, 117, 131- 

134, 137-142, 148-149 
(44, 106, 107, 109) 

Applesoft II BASIC Programming 

Reference Manual 26, 97, 101, 
111, 114, 126, 141, 143, 149 
Applesoft II Firmware Card 6, 

117, 131-134, 137-142, 148-149 
(106, 107, 109) 
arguments 35 

arithmetic 23-24, 59 (33, 36) 
arithmetic operators 23-24, 59 

(33, 36) 

precedence of 39-42 
arrays 108-111 (14, 18, 32, 58) 

error messages 110-111 
arrow keys 11, 27-29, 53, 114, 

128 (54, 55, 110-114, 150) 
arrow, upward pointing 24 
assertions, true and false 55-58 

(9) 
Autostart ROM 2, 147-148 



B 



backspace key 27-29, 53, 114, 128 
beep 10 

generating 78-81 

with LOAD and SAVE 12-13, 62, 
123, 136 



BELL 8, 10 

blinking square: see cursor 

booting DOS: see DOS 

bouncing ball 74-79 

branching 

FOR/NEXT 64-67, 116-117, 143, 

144 (11-14, 20, 78, 79, 152) 
GOSUB/RETURN 87-91, 117, 143, 
145, 146 

(15, 16, 79, 80, 119, 153) 
GOTO 50, 59, 63-64, 117, 146 

(76, 81, 153) 
IF/THEN 59-60, 119, 143, 146 
(9-10, 76, 154) 
bytes 131, 135, 136, 137-138 



cable 3, 5 

CALL -151 114, 133 

cassette Applesoft: see Applesoft 

BASIC 
CASSETTE IN jack 5 
cassette recorder 

plugging in 5 

setting the volume 11-14 
CASSETTE OUT jack 5 
CATALOG 16, 60, 114 
change program line: see editing 
CLEAR 104, 114 (8, 52, 150) 
clearing the screen 9, 12, 33, 

45, 118, 129-130 
colon 81 (10, 125) 
COL0R= 30-34, 115 (5, 11, 24, 

25, 85, 150) 
color (23-27, 85, 89, 131-134) 

high-resolution charts 92, 117 

low-resolution charts 18, 115 

names and numbers 18, 92, 115, 
117 

setting TV color 18-19 
COLOR DEMOSOFT 

on diskette 16, 18, 30 

on cassette tape 12, 18, 30 
columns 

tab fields: see tab 

with graphics 29, 62-63 
comma 68-69 (6, 70) 
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commands 114-1£5 (2, 122-123) 
concatenation 

strings 105, 145 (21, 71) 
CONT 51, 115, L*3 

(39, 40, 67, .51) 
Control: see CTRL key 
co-ordinates 

high-resolutiin 91, 95 

low-resolutioA 29, 64, 71, 
85-86 



CTRL B 137, 147. 
CTRL C 17, 50-:! 1, 

149 (7, id, :5, 
1(39, 151) 
CTRL key 10 q5, 
CTRL G 10 
CTRL S 75, 120 
CTRL X 54, 115, 129 

(55, 66, 69, ]|51) 
controller card 3, 16, 135 



149 
115, 120, 148- 
39, 40, 107- 

144) 



cursor 5, 10, 
cursor position 



52-53, 116, 124 



l|l, 13, 16, 22, 136 
10, 11, 27-29, 



(50-52, 54, 



55, 110-114, 131) 



debug mode: see [TRACE 
decimal places 25 (18, 22) 
deferred execution 44-45, 48, 143 

(2, 36, 134) 
DEL 49, 65, 115J, 129 (49, 151) 
delay loop 82 (27, 41-43, 97) 
delete 49, 54, 65, 115, 129 

(3, 38, 49) 
DIM 108-109, 115-116, 145 

(14, 58, 152) 
dimensions: see DIM 



re: see disk drive 
6, 15-16, 
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Disk II disk dri 
disk drive 3, 4, 

134-136 
diskette Applesoft: see Applesoft 

BASIC 
Disk Operating System: see DOS 
division 24, 39-42 

(2, 18, 33, 36 i 
DOS (Disk Operat:.ng System) 

booting 15-16 

commands 16, .14, 120, 123, 135 

memory requirenents 135, 137- 
138, 140-142 

recovering from accidental 
RESETs 148-] 49 



fe ! 






EAR or EARPHONE jack 5 
edit mode 52, 128 
editing (54, 55, 110-114) 

arrow keys 27-29, 53, 114, 128 

changing program lines 48-49, 
(54, 110-114) 

CTRL X 54, 115, 129 

DEL 49, 65, 115, 129 

pure cursor moves (ESC with I, J, 
K, and M) 52-53, 116, 128-129 
element 

arrays 108 

(14, 32, 58, 62-64) 
END 88, 90, 116 

(16, 39, 118, 152) 
equal sign 

as a replacement sign 36-39 
(12) 

in an assertion 55 (55) 
erasing 

programs 44-46, 121 (3, 38) 

the screen 9, 12, 33, 45, 
129-130 (52) 
ERR or ERRERR 12 
error messages 143-146 

(115-117, 167) 
ESC key 8-9, 52-53, 128-130 (35) 
execution 44-45, 48-49, 143 

(2, 36, 38-45) 
exponentation 24, 39-42 

(4, 5, 18, 31-33) 



firmware Applesoft 6, 117, 131- 

134, 137-142, 148-149 
(106, 107, 109) 
FLASH 68, 116 (53, 152) 
FOR/NEXT 64-67, 116-117, 143, 144 

(11-14, 20, 78, 79, 152) 
format: see number format 
function 35 (73, 102-104) 



game controls 3, 4, 20, 34, 48-51, 

121 (90, 134, 135) 
GAME I/O socket 4 
GOSUB/RETURN 87-91, 117, 143, 145, 

146 (15, 16, 79, 80, 119, 153) 



We 

& 
& 



! 



f 



GOTO 50, 59, 62-64, 117, 146 

(7, 76, 81, 153) 
GR 30, 33, 62, 86, 117 

(5, 11, 23-25, 84, 131-134, 
graphics 

high-resolution 91-97, 137 
(25-27, 87-1(39, 126, 131- 
low-resolution 29-34, 60, 
67, 74-79, 85-87, 89-91 
(5, 10, 23-25, 83-87, 
131-134) 
greater than [>] 55, 59 



153) 

-142 
134) 
«2- 



H 



HCOLOR 93-96, 117 

(26, 27, 89, 134, 153) 
hexadecimal 132 
HGR 92, 117-118, 137 (25, 2$, 84, 

87, 89, 98, 99, 153) 
HGR2 118, 138, 142 

(25, 84, 88, 89, 99,153) 
high-resolution graphics 91-V7 

(25-27, 87-100, 131-134) 

memory map 140-142 

memory range 140-142 (126] 

Page 2 118, 138, 142 
HIMEM: 140-142, 144 (41, 43, 44, 

99, 100, 123, 127, 154) 
HLIN 33, 118 (6, 25, 86, 154) 
horizontal lines, plotting: see 

HLIN 
HOME 45, 118, 130 

(11, 48, 52, 154) 
HPLOT 93-96, 118, 139 (26, #9, 

98, 131-134, 154) 
HTAB 70-71, 118 (27, 50, 51, 154) 



I key (with ESC): see editing 
IF/THEN 59-60, 119, 143, 146 

(9-10, 76, 154) 
ILLEGAL QUANTITY ERROR 32, 76 

144 
immediate execution 44-45, 14p 

(2, 36) 
IN USE light 6, 15 
incrementing in loops: see 

looping 
INPUT 75-77, 102, 119 

(7, 9, 66, 67, 141, 154) 



INT 83, 119 (19, 102, 155) 
integer (2, 4) 

INT function: see INT 

rounding 25 (18, 31) 

variables 36-38 (18, 31, 145) 
Integer BASIC 2, 132, 134, 136, 

148-149 
interrupting execution: see CTRL C 

and RESET 
INVERSE 68, 119 (53, 155) 



J key (with ESC): see editing 



K 



K key (with ESC) : see editing 
keyboard 7-11 (130) 
keyboard notation 9 



LEFT$ 101-102, 119, 144 

(20, 60, 124, 155) 
Left-arrow key 11, 27-29, 53, 114, 

128 (54, 55, 67, 110-114, 150) 
LEN 100-101, 120 (19, 59, 155) 
less than [<] 55, 59 
lines 

in a program 45-47, 81 
(2, 3, 36, 118, 141) 

in graphics mode 32-34, 118, 
124 (86, 89, 92-97) 
line number 45-47 

(2, 3, 35, 49, 145) 
LIST 44-46, 51, 120 

(3, 4, 48, 155) 
Little Brick Out 19-20 
LOAD 12-14, 61, 120, 136 

(38, 156) 
loading 

cassette Applesoft 

cassette programs 
136 (106-109) 

diskette Applesoft 

diskette programs 
LOMEM: 140-141, 144 



136-137 
11-14, 120, 

134-136 
61, 120 
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looping 50, 59, 62-67, 116-117 

(11-14, 20 ) 

incrementing 66, 116-117 
(13, 78) 
low-resolution graphics: see 

graphics 



M 



M key (with Est): see editing 
memory 131-132, 13 7-138 

(2, 8, 40, 4.) 

HGR2 118, l£8 t 

map 140-142 

requirements 
menu 1 7 

MIC or MICROPHONE jack 
MID$ 101-103, 

(20, 61, 156] 
modes 

debug: see TBIaCE 

execution: s^e execution 
modulator, RF 
MON or MONITOR 
Monitor progran 

entering 114 
Monitor ROM 2, 
monitor, TV 3-. 
moving the cursor 11, 27-29, 52- 



53, 114, 116, 
(50-52, 54, 



multiple statements on a line 
(10, 125) 



multiplication 



N 



142 (88) 
135, 136, 140-142 



121, 144 



3-4 
jack 5 

133, 148 
147-149 



128-129 

55, 110-114, 131) 

81-82 



negative number^ 39-42 
nested loops 66-67, 144 
NEW 44-46, 121 (3, 8, 38, 156) 
NEXT: see FOR/NfeXT 
NORMAL 68, 121i (53, 156) 
NOT 57 (33, 3*, 36) 
NOTRACE 88, m (40, 156) 
null string 10 . 
number format '5-2 6, 144 (4, 5, 
18, 22, 31-33 
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Old Monitor ROM 2, 
one (in assertions) 
OR 58-59 (33, 36) 



14 7-149 
55-58 



P 



paddle 34, 121 
parentheses 41-42, 58, 106 
pause: see delay loop 
PDL 34-35, 48-51, 94-95, 121 

(90, 157) 
PEEK 80-81, 141, 144 

(40, 131, 134-136, 157) 
PLOT 30-33, 121 

(5, 10, 24, 85, 157) 
. POKE 138, 144 
power cord 3 
POWER light 5 
power switch 5 
precedence of operators 39-42, 59 

(36) 
PRINT 22-23, 35, 44, 122 

(2, 6, 7, 70, 71, 157) 

comma 68-70, 122 

semi-colon 68-70, 122 
program, definition of 47 
prompt character 13, 17, 22, 133, 

136 (35, 84, 106, 108) 
PR// 16 (72, 158) 
pure cursor moves 52-53, 116, 128 



23, 39-42 (2, 33, 36) 



question mark 

INPUT 75-77 (7, 66, 67) 
quotation marks 

INPUT 76 (66) 

PRINT 22, 27, 36 

strings 100, 105 (19, 34) 



random number function: see RND 
REENTER 76 

REM 63, 122 (8, 10, 50, 118, 158) 
Replacing lines: see editing 
REPT key 10, 52, 122, 128 (55, 
111-114, 158) 



& 
fe 

& 
& 
& 
fc 
& 
fc 
fe 
fe 
& 

b 

E 

fe 
E 
E 
E 
E 
fc 
E 



1 

i 
i 
a 
i 
i 
a 
i 



i 
i 
i 
i 
i 
i 
i 
i 
i 
r 



reserved words 37, 126-127 (7, 8, 

38, 64, 87, 148) 
RESET key 6, 20, 51, 120, If 7 

recovering from 148-149 

stopping a program 51 (3JJ) 
RETURN 87, 122 

(15, 16, 79, 80, 158) 
RETURN key 10-11, 17, 26 

(2, 3, 7, 35) 
retype key 28-29, 53, 114, 128 
RF modulator 3 
RIGHT$ 101, 122, 144 

(20, 61, 158) 
right-arrow key 11, 27-29, 43, 

114, 128 (54, 55, 110-114J 150) 
RND 82-85, 123 

(18, 27, 102, 141, 159) 
ROM-Applesoft : see Applesoft II 

Firmware Card 
rounding 25 (4, 5, 18, 19, ,31-33) 

with graphics 64 
rows 29 
RUN 13, 14, 16, 17, 20, 44-46, 51, 

65, 123 (2, 8, 38, 39, 159) 



SAVE 60-62, 123 (38, 159) 
saving programs 

on diskette 60-61, 123 

on cassette tape 61-62, 123 
scientific notation 25-26 ^4, 5) 
screen 

clearing: see clearing the 
screen 

sketching screen program 63, 
94 
semi-colon 69, 76 (30, 33) 

INPUT 76 (66-67) 

PRINT 69 (6, 70, 71) 
setting the tape recorder 1 1| — 1 4 
setting the TV color 18-19 
SHIFT key 7 
slots through 7 16, 134 

(71, 72) 
sounds, generating 78-81 
spacing 69-71 
speaker 79-81 (134, 135) 
square bracket 11, 16, 22 
statements, multiple 81-82 (10, 125) 
STEP 66, 116-117 (13, 78, 1(52) 



stopping the computer 17 
listings 75, 115, 120 
programs 50-51, 115 
(7, 10, 16, 38, 39) 
STR$ 107, 124 (21, 22, 59, 160) 
strings 100-108 (18-23, 34) 

concatenation 105 (21, 52, 71) 
INPUT 102 (66, 67, 154, 155) 
LEFT$ 101, 119 (20, 60, 155) 
LEN 100-101, 120 (19, 20, 59, 

155) 
MID$ 101-103, 121 

(20, 21, 61, 156) 
null strings 101 (19, 60, 61, 

67, 69, 76, 77) 
RIGHT $ 101-102, 122 
STR$ 107, 124 

(21, 22, 59, 160) 
VAL 106-107, 124 
(21, 23, 59, 161) 
subroutine 85-91 

(16, 22, 79, 80) 
subscript 108, 144 

(14, 15, 34, 58) 
subtraction 23, 39-42 
SYNTAX ERROR 11, 12, 22, 32, 37, 

145 
System Master diskette 15, 16, 
134-135 



tab 

HTAB 70-71, 118 (50, 51) 

TAB 70-71, 124 (51, 160) 

VTAB 70-71, 125 (50) 
TEXT 30, 62, 88 (6, 11, 84, 160) 
THEN: see IF/THEN 
TO: see HPLOT and GOTO 
TRACE 87-88, 91, 124 

(40, 82, 161) 
TV monitor 3-4 



U 



VAL 106-107, 124 (21, 23, 59, 
161) 



155 



variables 37-138, 89 (7, 8, 31-35) 



array 108, 



110 (14, 58) 



143, 144 



FOR/NEXT loobs 64-67, 116,117, 



(12, 13, 78, 79) 



INPUT 75-77. 102-103, 119 
(7, 9, 66, 67, 71) 

integer 36-38 (18, 19, 31) 

names 36-38L 100, 120 
(7, 8, 14, [18 31-35) 

string 100- L04, 120 (18) 
vertical linesl plotting: see 

VLIN 
VIDEO OUT jack 

VLIN 33-34, lf4 (6, 25, 86, 161) 
VTAB 70-71, i:!5 (27, 50, 161) 



W 



X coordinate p, 64, 71, 85-87, 
91, 95 



Y coordinate 2^9, 64, 71, 85-87, 
91, 95 



143 



zero 8, 22, 
in assertions 
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55-58 
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